DanieleProcida

8 ms·

31.
by DanieleProcida 2y ago
The current title of this above ("Twelve rules for for job applicants at Canonical") isn't quite right. It's just supposed to be "Twelve rules for job applicants", and no "for for" either...
32.
Canonical's Open Documentation Academy(ubuntu.com)
5 points by DanieleProcida 3y ago|0 comments
33.
Pycon Namibia 2024(na.pycon.org)
1 points by DanieleProcida 3y ago|0 comments
34.
A perspective on attendee safety at Python community events(vurt.eu)
4 points by DanieleProcida 3y ago|1 comments
35.
by DanieleProcida 3y ago
https://ubuntu.com/blog/written-interviews
36.
by DanieleProcida 3y ago
Daniele here. Tutorials, how-to guides, reference, explanation are modes of documentation . They are not an exhaustive list of every kind of content that should appear in your documentation. Diátaxis is not a list of four boxes into whic
37.
Towards a Theory of Quality in Documentation(diataxis.fr)
3 points by DanieleProcida 3y ago|0 comments
38.
Developing a colorimetric mobile phone test for drink spiking(bbc.co.uk)
1 points by DanieleProcida 4y ago|0 comments
39.
by DanieleProcida 4y ago
You can turn it into a digital photo display. Put it in an IKEA Ribba 30x21cm frame: https://www.ikea.com/nl/nl/p/ribba-fotolijst-zwart-60378396/ . It's deep enough to accommodate the iPad and cable,
40.
How to collect better documentation feedback with linguistic theory(ubuntu.com)
1 points by DanieleProcida 4y ago|0 comments
41.
Engineering Transformation Through Documentation(ubuntu.com)
1 points by DanieleProcida 4y ago|1 comments
42.
by DanieleProcida 4y ago
I'd say it's the other way round. If you follow the Diátaxis model, and keep thinking about your material according to its principles, you will find that the structure starts to emerge. For an example, consider https://
43.
by DanieleProcida 4y ago
Hi! Author of Diátaxis here. Good question. And: > This framework is helpful for thinking about content You are absolutely right, it doesn't prescribe four boxes for all content to be forced into at all costs, it describes an approa
44.
by DanieleProcida 4y ago
Hello, it's me, the author of the article. Thanks for asking. I would ask not so much whether it has paid off or whether there was improvement, but whether it is paying off. We're not done yet, we have really only just got start
45.
by DanieleProcida 4y ago
Better at https://diataxis.fr , now.
46.
by DanieleProcida 5y ago
The people who are commenting that this is not something that could be used in a real-world situation are absolutely right. However, that's not what it's for - it's a study to determine whether the basic principles might be w
47.
Smartphone-based colorimetric determination of GHB and GBL in beverages(onlinelibrary.wiley.com)
31 points by DanieleProcida 5y ago|50 comments
48.
Diátaxis, a new foundation for Canonical documentation(ubuntu.com)
1 points by DanieleProcida 5y ago|0 comments
49.
The Future of Documentation at Canonical(ubuntu.com)
2 points by DanieleProcida 5y ago|0 comments
50.
by DanieleProcida 5y ago
This is a good question. Practical knowledge is knowing how to do something - tie your shoelaces, instantiate a model class, authenticate to an LDAP server. Theoretical knowledge is knowing what is the case - that the cross-flow valves must
51.
by DanieleProcida 5y ago
I would consider "a page where jargon is defined, like a lexicon" to be a perfect example of reference material.
52.
by DanieleProcida 5y ago
That's fine. Or a single "Explanation" or "About all this" page. Or just a paragraph on the main page. The scheme is not a plan that must be fulfilled, it's a guide or map to help you see where you are and wher
53.
by DanieleProcida 5y ago
Divio is a cloud management/application hosting platform. We use Docker for containerisation, and provide a unified integration layer to multiple different underlying vendors (AWS, Azure, etc). It means you can use the same tools (Cont
54.
by DanieleProcida 5y ago
Hi everyone. I'm Daniele, author of the framework. It now has its own domain, because it's about time. This is where it will continue to be updated and maintained. A quick clarification: I am still at Divio, but after a break in J
55.
Diátaxis, a systematic framework for technical documentation authoring(diataxis.fr)
3 points by DanieleProcida 6y ago|0 comments
56.
by DanieleProcida 6y ago
So far, it's only dependent upon luminosity - as long as it's not 0, it's considered ruined. And in reality, the unexposed frames wouldn't be ruined either (that's easy enough to model).
57.
by DanieleProcida 6y ago
I started exploring a graphical user interface too, using Anvil - https://camera.anvil.app . It only has two controls so far, but it's simply a matter of adding form elements and output for the existing objects.
58.
Show HN: C is for Camera, a 35mm film camera represented in Python objects(github.com)
103 points by DanieleProcida 6y ago|22 comments
59.
by DanieleProcida 6y ago
I don't disagree about the importance of introductions. I can't count the number of times I've looked at the home page of documentation for some product and it has felt like stumbling into a teenagers' conversation condu
60.
by DanieleProcida 6y ago
Perfect example (in the scheme) of an explanation/background/key concepts/discussion/whatever you call it document. That's where you weigh up options, discuss alternatives, etc. If it's something you could read

More ›