Documentation Issue Tracker on GitHub: Submit any Documentation Team-related issues on GitHubGitHubGitHub is a website that offers online implementation of git repositories that 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/
Join our discussions of documentation issues here on the blog and on Slack.
This template can be used for creating tutorials, whether they are in the handbooks or elsewhere. This should give you a format to follow and make it easier for you to get started writing your tutorial. You can use this template as a framework, replacing the text with your own.
The overview should introduce the reader to what they will do in the tutorial. You should provide an ordered list of what the reader will learn. When you have finished reading this tutorial, you will be familiar with:
Use this section to tell the reader what they will need, or any prerequisite knowledge they will require to complete the tutorial. For example:
a local WordPress installation or test site
a pluginPluginA plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party like Theme Check
to have read the page on Permalinks in the Codex
Replace these items with items specific to your tutorial.
The handbook plugin on 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/ will generate a in-page ToC at the top of the page. This will create a useful overview of the tutorial that the user can refer back to.
Step two should follow logically from the first step. This may seem intuitive but there are many tutorials out there that double back on themselves. A good approach to take is to work through the task, noting the steps in order as you do so.
On WordPress.org we use the Syntax Highlighter Evolved plugin. Wrap your code in the correct [language]shortcodeShortcodeA shortcode is a placeholder used within a WordPress post, page, or widget to insert a form or function generated by a plugin in a specific location on your site.. Commonly-used shortcode languages include php, htmlHTMLHTML is an acronym for Hyper Text Markup Language. It is a markup language that is used in the development of web pages and websites., css, js, sql, shell, and bash (see this reference for all available languages).
Tip: Follow the language and style used here. Use as few words as possible, and always write in the second person.