Viewing profile — DanieleProcida

At your request, https://diataxis.fr/atom.xml

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 …

Same fundamental ideas, but I got a lot of things wrong in that earlier version (which is several years old now).

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…

An investigation into LLMs in the service of software documentation processes, by Sally Makin at Canonical

I want to compile a list of companies that will employ people from Africa to work remotely. I'm referring to full-time permanent roles offering stability and career progression, ra…

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 acc…

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.

I've previously had good service and support from Gandi, but after a 30-hour outage, I need to consider alternatives. What do you recommend? The service needs to be based on in the…

I have just been able to log in to my IMAP account. Only one new message in there, from two minutes ago - which suggests that all messages to me have not even reached the inbox yet…

I have had excellent service and support from Gandi for several years. I appreciated having an EU-based provider that seemed to take pride in having a sustainable approach to the b…

> Also (separate complaint), whenever I want to tell anyone else about this "four kinds of documentation" approach, I always link to the archived https://web.archive.org/web/202003…

How technical authors at Canonical influence the design and direction of software products

> I’m not that impressed with Diataxis, considering it is basically describing the approach of Django project’s docs I worked on Django documentation and Diátaxis at the same time,…

There is no problem with Divio's site, see https://diataxis.fr/colophon/#origins-and-development . I started work on these ideas while still at Divio.

FAQ lists are the equivalent of the box in my garage where I put things when I've been told to get them out of the house, and I can't actually be bothered to put them in the right …

Examples in reference material are an excellent idea, and not at all in contradiction to the principles of Diátaxis. An example illustrates - like an illustration in any other refe…