DanieleProcida
Joined 11 years ago
Karma
830
Submissions
151
Member since
Mar 13
Recent submissions
Comment · 2 months ago
At your request, https://diataxis.fr/atom.xml
Comment · 3 months ago
I'd like to take advantage of the attention it's getting to point out that I am working on translating Diátaxis into other languages https://diataxis.fr/translation/, and you can see an in-progress version with some partially completed translations at https://diataxis-translated.readthedocs.io/translation/.
Comment · 3 months ago
Same fundamental ideas, but I got a lot of things wrong in that earlier version (which is several years old now).
Comment · 3 months ago
Ugh, I don't like that page and I have actually deleted it. It'll be gone soon.
There is a real problem there, and that page doesn't do a good enough job of dealing with it. I have something cooking that is much, much better.
Comment · 9 months ago
An investigation into LLMs in the service of software documentation processes, by Sally Makin at Canonical
Comment · 1 year ago
If creators of documentation are prepared to sacrifice its human purpose in order that LLMs can more effectively slurp it up and regurgitate it on demand, then they have meekly accepted values that more properly belong in a dystopian horror story.
Comment · 1 year ago
I don't believe teaching is really possible; I try to avoid doing it and I try to discourage other people from doing it too.