Re: [darktable-dev] Re: Introducing dtdocs

2020-10-19 Thread Mica Semrick
On 10/19/20 12:12 AM, juli...@i2pmail.org wrote: There's a saying, "Sorry I didn't have time to write less." :) Indeed that is true! Glad you see the need. About the choice between Hugo or Jekyll, The choice is Hugo, Jekyll was not a consideration. I realize that some may like the speed of

Re: [darktable-dev] Re: Introducing dtdocs

2020-10-19 Thread juliank
This is great. I'm relatively new Darktable but felt the need to refine the copy. Reducing written word down to its core parts does take time. There's a saying, "Sorry I didn't have time to write less." :) About the choice between Hugo or Jekyll, I realize that some may like the speed of Hugo,

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

[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

[darktable-dev] Re: Introducing dtdocs

2020-10-17 Thread Torsten Bronger
Hallöchen! Moritz Moeller writes: > [...] > > With the above in mind – if I were to start a documentation > project now I'd probably use this: > https://myst-parser.readthedocs.io/en/latest/ > > Which is kinda ReST + MD having a baby. :) IMHO, reStructuredText is not complicated enough for such