A plea for more guidance in the darktable manual

Back to the topic of documentation:

There are four kinds of documentation that need to exist to cover all the bases.

  • learning-oriented tutorials
  • goal-oriented how-to guides
  • understanding-oriented discussions
  • information-oriented reference material

This forum provides understanding-oriented discussions thanks to the people who author the tools, and the manuals for darktable and RawTherapee are very information-oriented for when you want to know what something does, but the other two are lacking.

I know Pat started PIXLS.US itself hoping to make a place for more tutorial type content, but most of the activity has been concentrated on the forum side of things rather than the website.

Goal-oriented guides are missing overall. There need to be lists of desired end results, like “My red flower petals are turning nuclear, how do I fix this?”, each with potentially several ways to achieve the result.

In Filmulator’s case I rely on the fact that the tools are few in number to help guide the user, but the other more powerful applications need to provide more guidance for a user who has an idea of what they want but not how to get it.

5 Likes