Re: [darktable-dev] Introducing dtdocs

2020-10-18 Thread Mica Semrick
Sorry, I must not have explained myself well enough. For dtdocs, we have pretty much chosen our tool chain, and we intentionally did not announce anything to avoid this type of bike shedding. While markdown has its negatives, the positive is that if you've written a comment on the internet in

Re: [darktable-dev] Introducing dtdocs

2020-10-18 Thread Mica Semrick
Before we open translations on weblate, I will take the current PO files, for both the application strings and the user guide, and make translation memory files out of them. I can then import them into weblate (PO editor also supports TMX files in recent versions), and if possible, translated s

[darktable-dev] Re: Introducing dtdocs

2020-10-18 Thread Torsten Bronger
Hallöchen! A question from a prospective reader rather than author: Why do you want to keep the number of words and images to a minimum? FWIW, I find both very helpful when reading about complex matters. Regards, Torsten. -- Torsten Bronger smime.p7s Description: S/MIME cryptographic signatu

Re: [darktable-dev] Re: Introducing dtdocs

2020-10-18 Thread Mica Semrick
Hey Torsten, Minimalism is a basic tenant of technical writing. We should strive to convey the "thing" in question using the fewest words and image to (1) reduce the maintenance overhead and (2) more words/images generally do not make the "thing" clearer, in fact, quite the opposite. It often