DanieleProcida

13 ms·

1.
by DanieleProcida 1mo ago
At your request, https://diataxis.fr/atom.xml
2.
by DanieleProcida 2mo 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 wi
3.
by DanieleProcida 2mo ago
Same fundamental ideas, but I got a lot of things wrong in that earlier version (which is several years old now).
4.
by DanieleProcida 2mo 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.
5.
AI-bots shall eat my docs(discourse.ubuntu.com)
3 points by DanieleProcida 8mo ago|1 comments
6.
by DanieleProcida 8mo ago
An investigation into LLMs in the service of software documentation processes, by Sally Makin at Canonical
7.
Ask HN: Which software companies hire people in Africa for remote work?
6 points by DanieleProcida 1y ago|3 comments
8.
Canonical's Engineering Practice Leadership Handbook(documentation.ubuntu.com)
1 points by DanieleProcida 1y ago|0 comments
9.
by DanieleProcida 1y 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
10.
My favourite German word(vurt.org)
1 points by DanieleProcida 1y ago|1 comments
11.
How to get a job at Canonical(ubuntu.com)
3 points by DanieleProcida 1y ago|0 comments
12.
Teaching(vurt.org)
2 points by DanieleProcida 1y ago|1 comments
13.
by DanieleProcida 1y 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.
14.
Fanaka – a handbook for African success in the international software industry(fanaka.readthedocs.io)
33 points by DanieleProcida 1y ago|5 comments
15.
Ask HN: What's a good EU-based alternative to Gandi for domain/email hosting?
1 points by DanieleProcida 2y ago|0 comments
16.
by DanieleProcida 2y ago
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
17.
by DanieleProcida 2y ago
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
18.
Engineering Ubuntu for the Next 20 Years(discourse.ubuntu.com)
4 points by DanieleProcida 2y ago|3 comments
19.
by DanieleProcida 2y ago
> 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:/
20.
Documentation, development and design for technical authors(ubuntu.com)
2 points by DanieleProcida 2y ago|1 comments
21.
by DanieleProcida 2y ago
How technical authors at Canonical influence the design and direction of software products
22.
by DanieleProcida 2y ago
> 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.
23.
by DanieleProcida 2y ago
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.
24.
by DanieleProcida 2y ago
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.
25.
by DanieleProcida 2y ago
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
26.
by DanieleProcida 2y ago
Why do you think the version on the Divio site is better - what's more intuitive about it?
27.
by DanieleProcida 2y ago
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.
28.
Twelve rules for job applications and interviews(vurt.org)
4 points by DanieleProcida 2y ago|1 comments
29.
by DanieleProcida 2y ago
Twelve principles that job candidates can put into practice, to improve the quality of their applications and their performance in interviews.
30.
Where the computer industry went wrong – the early hits(theregister.com)
4 points by DanieleProcida 2y ago|0 comments

More ›