Update of Darktable user manual for v4.2

Please can we have an update to the Darktable user manual to support the current v4.2.0 software.
There are so many great new features that need explanation and elaboration.

Thanks

The user manual is mostly a one-man operation at the moment. We changed the format of it to make it easier to contribute but it seems that didn’t help much. I am updating it as-and-when I have time but I have other things going on at the moment.

5 Likes

And here is the link to the current draft version.

https://docs.darktable.org/usermanual/4.2/en/

2 Likes

I’d love to contribute, but I probably don’t have the detailed knowledge of the code, or of git. Is there any thing that could be done by an enthusiastic amateur?

I don’t know. It’s as much about knowing how to use the modules as reading the code but then as reviewer I need to understand whether what’s proposed is correct. Ideally the developers would write the documentation for their own code but that’s not as fun as building stuff so most don’t bother. Either that or they only provide very brief summaries in their pull requests which are out of date by the time the feature is merged (because loads of changes happen in the comments). Sometimes what takes longest is sorting through pages of comments trying to work out what was actually implemented. Or worse when a feature is implemented in one pull request and then subtly modified over a few subsequent changes merged following feedback.

There’s not much left on the list for the 4.2 manual. Here is a summary of the remaining stuff (plus a couple of issues in the dtdocs repository): Pull requests · darktable-org/darktable · GitHub

1 Like

You don’t need any git commands if you’re willing to click though github.