Make it so easy no manual is needed.
After having been subjected to this dumbification of software I myself use I'm starting to have doubts: my search engine is broken, every app is hiding the menus thereby hampering discoverability, plugin APIs gets neutered and won't be fixed because "it can confuse users".
I'm well and truly fed up.
Which is exactly why Darktable is special: it is verbose and technical, but offers deep control and complexity, which is truly unique in image editors.
(I want to compare it to Emacs, but it sort of lacks the extensibility to be a good analogy. But it is certainly more emacsian in spirit than any other image editor)
Sure, you can implement some UX to show the differences between different demosaicing methods and how good they are, but you're going to implement an interactive toy/tutorial (so another form of a manual), or you'll end up failing to explain the theory.
This idea that software should always come to us, and not the other way around, is untenable. And, I think, selfish.
On the other hand, Darktable's UI would benefit from some polishing, and perhaps a more gentle learning curve for beginners to become productive. This is very common in open source applications, as there tend to be more programmers contributing than UX designers.