The WordPress training team helps people learn to use, extend, and contribute to WordPress through synchronous and asynchronous learning as well as downloadable lesson plans for instructors to use in live environments, via learn.wordpress.org.
GitHub issues – Learn.WordPress.orgWordPress.orgThe community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/ site functionality
Our lesson plans have code snippets. We’ve moved from storing the lesson plans on this team handbook to GitHubGitHubGitHub is a website that offers online implementation of git repositories that can can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/ and then to Learn. As such, some bits of code may not be formatted correctly.
When you visit Lesson Plans > All Lessons, you can view the columns where the taxonomy is available.
Within each lesson, look also at the Editorial Metadata. This may appear in the right sidebarSidebarA sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme. under the document tab OR beneath the post editor content.
Contributions are welcome to do a quick pass to ensure formatting has been established and for any obvious code conversion issues.
Leave a message in the Training team Slack for the fastest access to the Learn siteLearn siteThe Training Team publishes its completed lesson plans at https://learn.wordpress.org/ which is often referred to as the "Learn" site. expressing interest in contributing.
View Lesson Plans > All Lessons on Learn to locate which plans contain a code snippet.
Edit a lesson that contains a snippet.
When converting posts to the BlockBlockBlock is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. Editor mode, code snippets will default to a Code block. Modify this to the Syntax Highlighter block.
At this point, it may be beneficial to cross-check code with what appears on GitHub. A few cases of code not displaying in the editor but being live and inaccurate have occurred on published lesson plans. Copy/pasting from GitHub to Syntax Highlighter block usually works.
Then in the right sidebar, select the language with Line Numbers enabled.
When you’ve finished proofreading each lesson, check the Edit Flow box for Code snippet proofread.