The darktable user manual is largely outdated. Problem is it uses an esoteric kind of XML required by a brittle software stack (Saxon) to be compiled into HTML or PDF.
This complexity steers away many contributors.
But thanks to Chris Elston, @secretlifeofmatt and @paperdigits, it is being rewritten in Markdown with a better "tutorial" approach.
WIP : https://elstoc.github.io/dtdocs/
Contribute : https://github.com/elstoc/dtdocs
@mondstern because there will always be a newer, cooler and nicer plateform somewhere else, but at some point the job needs to be done. We can't switch platforms every year, it's too much overhead for everyone.
(To be clear, "the job" is developing image processing software, not developing migration scripts and other tools to set the tools to set the tools to do the job).
If you don't like github, don't use it. We all understand the trade offs being made, and thus far we have reasoned that the effort necessary to move *all the people* (not the code so much) to another platform is not worth it.
@marcelcosta @darktable @mondstern wrong, you exclude yourself from the project by refusing to use github (apparently). I haven't denied your contributions in any way. I have expressed my frustration in sinking a lot of hours into something, only to be lectured by multiple people about topics I'm already well aware of, thought about, and came to different conclusions. It seems you can't handle different opinions, and that is OK with me.
We've built a new house and you're lecturing us about the ethics of the store where we bought the nails, but you don't understand how that is frustrating... OK then, not sure what to tell you.
We don't have to reach a point of agreement. I've spent many hours trying to improve a project because I felt the choices of that part of the project were a hindrance. If you feel the same way you can take action to do what you feel betters the project.
the team needed a redmine replacement, move to github before MS ate it, it mostly works from a technical perspective. Redmine was a drag. If we had to shift every time some company was acquired, nobody would ever write darktable code, we would spend all our time convincing people this new host is better.
Server run by the main developers of the project It is not focused on any particular niche interest - everyone is welcome as long as you follow our code of conduct!