User Documentation Structuur
De huidige vijf stappenplannen werden voor het eerst gepubliceerd als artikelen in het Joomla Community Magazine, geschreven door Brian Teeman en door hem ingediend voor deze documentatie.
We werken nog aan de menustructuren om stappenplannen, tutorials, uitleg enzovoort zodanig te plaatsen dat ze dynamisch gefilterd en geordend kunnen worden. Maar voorlopig publiceren we deze stappenplannen gewoon in willekeurige volgorde.
Over stappenplannen
Van https://diataxis.fr/how-to-guides/:
Stappenplannen zijn aanwijzingen die de lezer door een probleem heen leiden of naar een resultaat toe begeleiden. Stappenplannen zijn doelgericht.
Een stappenplan helpt de gebruiker iets correct en veilig voor elkaar te krijgen; het begeleidt de handeling van de gebruiker.
Het gaat om werk - het navigeren van de ene kant naar de andere kant van een probleemveld uit de praktijk.
Voorbeelden zijn: hoe de radararray te kalibreren; hoe fixtures te gebruiken in pytest; hoe reconnection back-off beleid te configureren. Daarentegen is hoe een webapplicatie te bouwen dat niet - dat richt zich niet op een specifiek doel of probleem, het is een enorm open vaardigheidsgebied.
Stappenplannen zijn niet alleen belangrijk omdat gebruikers dingen voor elkaar moeten kunnen krijgen: de lijst met stappenplannen in uw documentatie helpt het beeld te vormen van wat uw product daadwerkelijk kan. Een rijke lijst met stappenplannen is een bemoedigende suggestie van de mogelijkheden van een product.