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
but we finally decided to switch to markdown, too. i think that is the right direction to make contributing as easy as possible ✨
@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).
staying on Github is a matter of features. Leaving it would be a matter of ideology, at the expense of features. Besides, everything we host on Github is public anyway, the most private things would be email adresses but any other Git platform will store them in commits just as well.
@tuttle @marcelcosta @darktable @codeberg @mondstern I don't need you to mansplain github. We are on github because the main project is there, because of the network effect, and because someone else maintains github. Before github the project used redmine, which was a strain on the small Dev team. The darktable team moved before Microsoft acquired github. Moving would be another burden on the project that we don't need.
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.
@marcelcosta @darktable @mondstern if the ethics of it all are so important to you and everyone else on this thread who are choosing to focus on platform choice rather than the efforts us volunteers have put into trying to improve a project that we value, the please maintain a separate code base on a platform that aligns with your ethics. The people who agree with you will flock to that and improve darktable so much that we will be overwhelmed and grateful.
At some point you have to choose some tools and go for it. We choose a popular tool chain because its popular.
Why not asciidoc? Troff? Nroff? Latex? Our own custom XML format! This argument goes on and on
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!