WordPress.org

Welcome to the official home of the WordPress documentation team.

This team is responsible for all things documentation, including the Codex (moving to HelpHub), handbooks, developer.wordpress.org, admin help, inline docs, and other general wordsmithing across the WordPress project.

Want to get involved?

We need your help keeping content current with each WordPress release and adding new content and screenshots to:

the many Contributor handbooks.
WordPress inline docs.
developer.wordpress.org.
HelpHub which will be replacing the Codex.

Weekly Meetings

Join our discussions of documentation issues here on the blog and on Slack.

The documentation team holds bi-weekly office hours on Mondays from 15:00-16:00 UTC in the #docs Slack channel.

Individual teams have their own regular meetings – you can find details of those in the sidebar.

Home / Handbook / Code Reference / Editing Articles

Editing Articles

Overview Overview

As part of the official documentation roadmap devised by the Docs team in Cincinnati in 2013, much of the work the docs team is doing of late centers around migrating useful content from the Codex to official handbooks or to the developer hub, with the ultimate goal being to eventually shut down the Codex.

NOTE: User documentation such as installation, maintenance and how-to-use guide are migrated into ‘HelpHub’. Refer https://make.wordpress.org/docs/handbook/helphub/

Top ↑

Getting Started Getting Started

To begin, we’re tracking migration of Codex to the Code Reference in this spreadsheet:

https://docs.google.com/spreadsheets/d/15hpEbbnuWJZ0DJafyCeG3CFRMtSxX1gY-RObrrjzzdw/edit#gid=0

Functions and Hooks contents are migrated as in-line docs. Classes contents are migrated as in-line docs and ‘Explanation’ field in Code Reference. Also, all Example (or Usage) are migrated as user comment.

Contents Migration Contents Migration

Contents should be converted to inline docs. You need developer’s environment for it. Please refer:
https://make.wordpress.org/docs/handbook/core/inline-docs/

Top ↑

Class contents Migration Class contents Migration

Refer WP_Query Code Reference. Basic descriptions are in-line docs, but almost all explanations are in the ‘Explanation’ custom field. Follow the same convention for other classes.

Top ↑