10up опубликовал веб-сайт Gutenberg Best Practices в качестве общедоступного ресурса с учебными пособиями, документацией и примерами кода. Поддержание текущей документации не было сильной стороной официального проекта Gutenberg, поскольку темпы проекта затрудняют отставание участников и расширителей.
«Gutenberg представил совершенно новую редакционную парадигму для создания контента и создания страниц в WordPress», — сказал заместитель директора 10up по редакционному проектированию Фабиан Кэги. «Поскольку редактор блоков все еще довольно новый, он быстро развивается, и изменения вносятся регулярно; как таковые, возможности для обучения ограничены, и мы ощущаем отсутствие документации по передовому опыту, которая соответствует стандартам мастерства 10up».
Рекомендации 10up Gutenberg Best Practices были написаны, чтобы дополнить основную документацию WordPress тем, что, по словам Кэги, является «подходом, более ориентированным на клиентские услуги, адаптированным к инженерному редакционному опыту на уровне предприятия».
Для разработчиков, которые только начинают работать с редактором блоков, раздел « Справочник » содержит массу информации об анатомии блока, основах создания тем блоков с помощью theme.json, расширениях блоков, вариантах блоков и многом другом, а также вспомогательные видеоролики. и гифки. Документация также дает немного больше контекста для практического использования. Например, раздел о блочных преобразованиях включает информацию о том, когда и как определять блочные преобразования.
Раздел «Обучение» рекомендаций Gutenberg Best Practices от 10up содержит мини-ускоренный курс по файловой структуре блока и всех его компонентов, а также о том, как создать собственный блок с помощью 10up Starter Block . Это особенно полезно для разработчиков, которые ищут дополнительные рекомендации по разработке своих первых блоков.
Раздел « Руководства » содержит более сложные темы, такие как расширение основных блоков и включение внешнего интерфейса JS с блоком. Документация доступна на GitHub , и любой может внести изменения. На сайте также есть ссылка на доску обсуждений на GitHub , где разработчики могут присоединиться к обсуждениям и обсудить лучшие практики в сотрудничестве с сотрудниками 10up. 10up опубликовал веб-сайт Gutenberg Best Practices с обозначением бета-версии и намерен обновлять и расширять его по мере развития WordPress.
