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 fetchmail running, it's slow, but I'm getting all of my emails delivered (I have a forward to protonmail to compare).

EDIT: I don't have visibility for emails not forwarded during the initial outage so nothing before 07:30 UTC yesterday.

My mail has been coming in slowly since 30 minutes ago. I am going to give the mail some time to arrive, and then I will migrate my mail to mailbox.org instead.

I can also login via IMAP (but no via the webmail), but emails sent to my account 10 hours ago and 2 hours ago are still not delivered.

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.

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.

Golang API pages collect all examples into a list at the top. Maybe do the same kind of things for stuff like "Quick explanations" and "Warnings/Gotchas". But it would get very subjective and potentially very messy and unmaintainable.