Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add a new "Create a block tutorial" #56305

Closed
ndiego opened this issue Nov 19, 2023 · 1 comment · Fixed by #56931
Closed

Add a new "Create a block tutorial" #56305

ndiego opened this issue Nov 19, 2023 · 1 comment · Fixed by #56931
Assignees
Labels
Developer Experience Ideas about improving block and theme developer experience [Feature] Block API API that allows to express the block paradigm. [Status] In Progress Tracking issues with work in progress [Type] Developer Documentation Documentation for developers [Type] Enhancement A suggestion for improvement.

Comments

@ndiego
Copy link
Member

ndiego commented Nov 19, 2023

Recently, a new Quick Start Guide was added to the Block Editor Handbook (#56056). This guide introduced a "Copyright Date" block that utilizes static and dynamic rendering, block supports, custom attributes, and a custom Settings panel. This block was also intended to form the foundation of a new "Create a block tutorial".

This new tutorial will better represent how blocks can be built today and will also take a more streamlined approach. Instead of a multi-page tutorial, it will be a single page, much like React's tic-tac-toe tutorial. The goal is to improve the onboarding experience for new block developers.

This tutorial will also be closely tied to the work being done in #56282. The tutorial will walk developers through the steps of building the block and reference the "Fundamentals of Block Development" docs for further reading.

@ndiego ndiego added [Type] Enhancement A suggestion for improvement. [Type] Developer Documentation Documentation for developers Developer Experience Ideas about improving block and theme developer experience labels Nov 19, 2023
@ndiego ndiego self-assigned this Nov 19, 2023
@gziolo gziolo added the [Feature] Block API API that allows to express the block paradigm. label Nov 24, 2023
@gziolo gziolo mentioned this issue Nov 24, 2023
69 tasks
@ndiego
Copy link
Member Author

ndiego commented Dec 1, 2023

The new "Tutorial: Build your first block" is drafted here in Google Docs. Before creating a PR, this tutorial needs to be thoroughly tested and edited. Please add notes here or directly in the doc itself. Thanks!

https://docs.google.com/document/d/15n3KrFCd8sZmy2DOjk3Vf-UABIOZ7kwBhO_HjyXzYvE/edit

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Developer Experience Ideas about improving block and theme developer experience [Feature] Block API API that allows to express the block paradigm. [Status] In Progress Tracking issues with work in progress [Type] Developer Documentation Documentation for developers [Type] Enhancement A suggestion for improvement.
Projects
None yet
2 participants