A 10up publicou um site Gutenberg Best Practices como um recurso público com tutoriais, documentação e código de exemplo. A manutenção da documentação atual não tem sido um ponto forte do projeto oficial do Gutenberg, pois o ritmo do projeto dificulta o acompanhamento dos colaboradores e extensores.
“Gutenberg introduziu um paradigma editorial totalmente novo para criação de conteúdo e construção de páginas no WordPress”, disse o Diretor Associado de Engenharia Editorial da 10up, Fabian Kaegy. “Como o editor de blocos ainda é relativamente novo, ele está avançando rapidamente e as alterações são introduzidas regularmente; como tal, as oportunidades de aprendizado são escassas e sentimos uma ausência de documentação de melhores práticas que atenda aos padrões 10up para artesanato.”
As práticas recomendadas de Gutenberg da 10up foram escritas para complementar a documentação principal do WordPress com o que Kaegy disse ser uma “abordagem mais centrada em serviços ao cliente, adaptada às experiências editoriais de nível corporativo de engenharia”.
Para desenvolvedores que estão começando a trabalhar com o editor de blocos, a seção Referência tem muitas informações sobre a anatomia de um bloco, os fundamentos da temática de bloco com theme.json, extensões de bloco, variações de bloco e muito mais, com vídeos de suporte e gifs. A documentação também fornece um pouco mais de contexto para uso prático. Por exemplo, a seção sobre Transformações de bloco inclui informações sobre quando e como definir transformações de bloco.
A seção Treinamento das Melhores Práticas de Gutenberg do 10up contém um minicurso intensivo sobre a estrutura de arquivos de um bloco e todos os seus componentes, e como construir um bloco personalizado usando o Bloco Inicial 10up. Isso é especialmente útil para desenvolvedores que procuram orientação extra para desenvolver seus primeiros blocos.
A seção Guias contém tópicos mais avançados, como estender blocos principais e incluir JS de frontend com um bloco. A documentação está disponível no GitHub para qualquer pessoa contribuir com edições. O site também tem links para um fórum de discussão no GitHub, onde os desenvolvedores são bem-vindos para participar de discussões e workshops sobre as melhores práticas em colaboração com funcionários da 10up. A 10up publicou o site Gutenberg Best Practices com uma designação beta e pretende atualizá-lo e expandi-lo à medida que o WordPress evolui.
