10up a publié un Meilleures pratiques de Gutenberg site Web en tant que ressource publique avec des didacticiels, de la documentation et des exemples de code. Le maintien de la documentation à jour n’a pas été un point fort du projet officiel Gutenberg car le rythme du projet rend difficile le suivi des contributeurs et des extenseurs.
“Gutenberg a introduit un tout nouveau paradigme éditorial pour la création de contenu et la création de pages dans WordPress”, a déclaré Fabian Kaegy, directeur associé de l’ingénierie éditoriale de 10up. “Parce que l’éditeur de blocs est encore relativement nouveau, il progresse rapidement et des changements sont introduits régulièrement ; en tant que tel, les opportunités d’apprentissage sont rares et nous avons ressenti une absence de documentation sur les meilleures pratiques qui répond aux normes 10up pour l’artisanat.
Les meilleures pratiques Gutenberg de 10up ont été rédigées pour compléter la documentation de base de WordPress avec ce que Kaegy a déclaré être une “approche plus centrée sur les services client et adaptée aux expériences éditoriales au niveau de l’entreprise”.
Pour les développeurs qui débutent avec l’éditeur de blocs, le Référence La section contient une mine d’informations sur l’anatomie d’un bloc, les principes fondamentaux de la thématisation des blocs avec theme.json, les extensions de blocs, les variations de blocs, etc., avec des vidéos et des gifs à l’appui. La documentation donne également un peu plus de contexte pour une utilisation pratique. Par exemple, la section sur Transformer les blocs inclut des informations sur quand et comment définir les transformations de blocs.
La section Formation des meilleures pratiques Gutenberg de 10up contient un mini cours accéléré sur la structure de fichier d’un bloc et tous ses composants, et sur la façon de créer un bloc personnalisé à l’aide du Bloc de démarrage 10up. Ceci est particulièrement utile pour les développeurs à la recherche de conseils supplémentaires pour développer leurs premiers blocs.
La Guides La section contient des sujets plus avancés tels que l’extension des blocs de base et l’inclusion de JS frontal avec un bloc. La documentation est disponible sur GitHub à quiconque de contribuer aux modifications. Le site propose également des liens vers un forum de discussion sur GitHub où les développeurs sont invités à participer à des discussions et à des ateliers sur les meilleures pratiques en collaboration avec les employés de 10up. 10up a publié le site Web Gutenberg Best Practices avec une désignation bêta et a l’intention de le mettre à jour et de l’étendre à mesure que WordPress évolue.
— to wptavern.com