User Documentation Structure
The current five how-to guides were first published as articles in the Joomla Community Magazine, written by Brian Teeman and submitted by him for this documentation.
We are still working on the menu structures to place how-to guides, tutorials, explanations etc. in such a way that they can be dynamically filtered and ordered. But for now we will just publish those how-to guides in a random order.
About how-to guides
From https://diataxis.fr/how-to-guides/:
How-to guides are directions that guide the reader through a problem or towards a result. How-to guides are goal-oriented.
A how-to guide helps the user get something done, correctly and safely; it guides the user’s action.
It’s concerned with work - navigating from one side to the other of a real-world problem-field.
Examples could be: how to calibrate the radar array; how to use fixtures in pytest; how to configure reconnection back-off policies. On the other hand, how to build a web application is not - that’s not addressing a specific goal or problem, it’s a vastly open-ended sphere of skill.
How-to guides matter not just because users need to be able to accomplish things: the list of how-to guides in your documentation helps frame the picture of what your product can actually do. A rich list of how-to guides is an encouraging suggestion of a product’s capabilities.