Welcome to the official home of the WordPress documentation team.
This team is responsible for coordinating all documentation initiatives around WordPress, including the Codex (moving to HelpHub and DevHub), handbooks, parts of developer.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/, admin help, inline docs, and other general wordsmithing across the WordPress project.
Want to get involved?
There are many ways in which you can help the Docs team. Every small contribution counts and helps! You can report an issue or typo you found in the docs, or even help us write new documentation for parts that are still missing. These are some helpful links to find out more about what we do and how to collaborate:
Block Editor Handbook: An overview of documentation contributions of 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 / GutenbergGutenbergThe Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/
Documentation Issue Tracker on GitHub: Submit any DevHub/HelpHub/”Doc Team Handbook” Docs-related issue on 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/.
Weekly Meetings
Join our discussions of documentation issues here on the blog and on Slack.
Project HelpHub is the user documentation base that will sit 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//support. It's the companion to Developer's Hub which serves development documentation.
The general guiding philosophy for the design, content creation, and build of the project is – Help users help themselves.
We want users to be able to find answers on WordPress.org before posting on the forums. We want to make documentation more discoverable, through enabling search, visual improvements and concise targeted content.
We've been working on HelpHub for some time now and its possibly the final item that needs completion from the roadmap created by the Docs Team way back in 2013.
What’s the difference?
The biggest change is actually using WordPress to power content!
Shifting away from Codex was a deliberate decision
What we like about the Codex
What we hate about the Codex
Developer issues with the Codex
User issues with the Codex
Codex traffic breakdown
Scribbles the Docs Team did in 2013, suffice to say Codex wasn't enough
Too many pages that deal with the same issue (we have 4 getting started pages!)
Conflation of user and developer content
Content is hard to navigate
Content is way way way way way too verbose
Too much irrelevant content
Codex couldn't be realistically improved in it's functionality to deliver meaningful content
HelpHub aims to curate articles in a more concise way with standardised formatting and screenshots where possible.
Up-to-date screenshots
Consistent formatting, improved readability
Proper editing via WordPress back end & GutenbergGutenbergThe Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/
Better categorisation & discovery
Gutenberg Editing
The possibility to add functionality as need arises
Adding read time to help keep articles concise
Current State
We want to release a minimum viable productMinimum Viable Product"A minimum viable product (MVP) is a product with just enough features to satisfy early customers, and to provide feedback for future product development." - WikiPedia, and we have classified it as such below:
MVPMinimum Viable Product"A minimum viable product (MVP) is a product with just enough features to satisfy early customers, and to provide feedback for future product development." - WikiPedia – Plenty better than Codex
Better content
Internal search
Improved readability through design and content re-writes
Better article discovery through better categorisation
REST APIREST APIThe REST API is an acronym for the RESTful Application Program Interface (API) that uses HTTP requests to GET, PUT, POST and DELETE data. It is how the front end of an application (think “phone app” or “website”) can communicate with the data store (think “database” or “file system”) https://developer.wordpress.org/rest-api/. endpoints
Phase 2 & beyond – Iteration
Phase 2 & beyond will have the team working on the enhancements on top of the basic features. We'll keep iterating to make things more use-able, easier for people to collaborate and of course create better content.
Examples are
WordPress Search -> ElasticSearch
Simple input search -> Auto complete and Suggestions via JS
And more
We'll also work on new features based on understanding how well the basic ones work and what the general end public needs next. Such could be article voting, direct article contribution via Feedback or user guides for example.
Team
Many people came in to help, unfortunately, life happens. We will need some consistent help going forward.
It is also plainly obvious that having an overall project lead isn’t enough to help tackle the pre-launch needs, let alone the post launch ones.
They have already been doing these tasks but it would be great to properly introduce them
Our focus right now is to complete the development work for MVP and also work with the MetaMetaMeta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. and Support Team to properly setup HelpHub on WordPress.org
We aim to release HelpHub latest by 31st May 2018. We are working however to release it earlier than that.
Progress of Phase 1 (MVP)
Articles are appropriately categorised
Many popular articles were re-written
General WordPress.org styling are being merged in
We're now focusing on the tasks needed to ensure proper integration to be the Hub Page of WordPress.org/support
What do we need?
Developers. Consistent developers who are familiar with WordPress & PHPPHPPHP (recursive acronym for PHP: Hypertext Preprocessor) is a widely-used open source general-purpose scripting language that is especially suited for web development and can be embedded into HTML. http://php.net/manual/en/intro-whatis.php. coding standards and good practices.
Content Migrators and Editors who are familiar with editing in WordPress.
If you would like to join us, you can do so in the following ways
Comment here
Join us at HelpHub meetings Tuesdays at 15:00 UTC in #docs
PingPingThe act of sending a very small amount of data to an end point. Ping is used in computer science to illicit a response from a target server to test it’s connection. Ping is also a term used by Slack users to @ someone or send them a direct message (DM). Users might say something along the lines of “Ping me when the meeting starts.”@clorith or @zzap for development, @atachibana for content on Make WordPress SlackSlackSlack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/.
Take a look
We have the the staging version of the site up. (It still requires a fair bit of styling fix but the fundamental code to run it is in). It's not the prettiest right now but we're working on it. And we could certainly use your help!.
