User Documentation Structure
Les cinq guides pratiques actuels ont d'abord été publiés comme articles dans le Joomla Community Magazine, écrits par Brian Teeman et soumis par lui pour cette documentation.
Nous travaillons encore sur les structures de menu pour placer les guides pratiques, tutoriels, explications, etc. de manière à ce qu'ils puissent être filtrés et triés dynamiquement. Mais pour l'instant, nous publierons simplement ces guides pratiques dans un ordre aléatoire.
À propos des guides pratiques
Extrait de https://diataxis.fr/how-to-guides/ :
Les guides pratiques sont des indications qui guident le lecteur à travers un problème ou vers un résultat. Les guides pratiques sont orientés objectif.
Un guide pratique aide l'utilisateur à accomplir quelque chose, correctement et en toute sécurité ; il guide l'action de l'utilisateur.
Il concerne le travail - naviguer d'un côté à l'autre d'un champ de problèmes du monde réel.
Voici des exemples : comment calibrer le réseau radar ; comment utiliser les fixtures dans pytest ; comment configurer les politiques de reconnexion. En revanche, comment construire une application web n'en est pas un - cela ne répond pas à un objectif ou à un problème précis, c'est une sphère de compétences vastement ouverte.
Les guides pratiques sont importants non seulement parce que les utilisateurs doivent pouvoir accomplir des choses : la liste des guides pratiques dans votre documentation aide à dresser le tableau de ce que votre produit peut réellement faire. Une liste riche de guides pratiques est une suggestion encourageante des capacités d'un produit.