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 see an in-progress version with some partially completed translations at https://diataxis-translated.readthedocs.io/translation/.

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 something cooking that is much, much better.

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

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.

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 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.

Some deliveries will be retried, but after 30+ hours some will have permanently failed.

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 business. There was clarity about pricing. It wasn't the cheapest but they were straightforward and honest in communications.

Every company has an outage now and then, and sometimes a bad one.

But, it has now been 30 hours since I had access to my email. The last update was 15 hours ago. I don't like the way this has been handled.

> 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/20200312220117/https://www.divio... which is the latest version that is entirely on a single page.

That's a mistake in my opinion. The big compass of four kinds of documentation I eye-catching and memorable, and I am sure it is part of the success of Diátaxis.

But what gets me out of trouble in my own work every time is https://diataxis.fr/compass/. It's one thing to have the general idea; it's another to be armed with an effective tool to apply to work.

The site doesn't just contain opinions and ideas, it also contains tools, that really are worth using.

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, so naturally you will see a lot of the same patterns.

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 place.

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 reference guide - and provides something concrete to help grasp what's being described.

That's different from a how-to, talking someone through a problem.

Why do you think the version on the Divio site is better - what's more intuitive about it?

Explained in https://diataxis.fr/colophon/#origins-and-development. No malfeasance! But I wish Divio would take that down, it's past its sell-by date now, and I think I got quite a few things in it wrong.

Twelve principles that job candidates can put into practice, to improve the quality of their applications and their performance in interviews.