Want a high impact, low friction way to help out with the WordPress documentation project? Adopt a Page in the Codex!
The Documentation project is rumbling along, with handbooks and code reference underway. But in the meantime, we need to keep the Codex updated. Below is a list of the top 20 most visited narrative pages in the Codex. This does not include the reference pages, which I’ve excluded since we’re addressing that problem in a different way.
I’m looking for volunteers to take responsibility for one page of the Codex to be their very own. If you want to be involved with docs, but don’t have time to get really involved with the overall project, this is a great way to help out in a big way. The total uniques for these pages in one month is 1,615,139! If we can make these pages beautiful that’ll have a big impact on Codex users.
The pages are:
| PageViews | Uniques | Responsible | ||
|---|---|---|---|---|
| Installing WordPress | 307562 | 229754 | Amanda | |
| Editing wp_config.php | 156380 | 127632 | Rami Yushuvaev | |
| First Steps with WordPress | 132409 | 101865 | Rami/Eric | |
| Theme Development | 129424 | 105878 | Michael Chacon | |
| Pages | 123979 | 99941 | Ben Hubbard & hearvox | |
| Using Permalinks | 120125 | 98980 | ||
| Child Themes | 108800 | 81198 | Morgan Kay & Ulrich | |
| Moving WordPress | 102524 | 81198 | ||
| Giving WordPress its Own Directory | 91232 | 75590 | vancoder | |
| New to WordPress? Where to Start | 84243 | 62195 | Rami/Eric | |
| Changing File Permissions | 81044 | 67013 | ||
| Create a Network | 73205 | 53033 | ||
| Changing the Site URL | 73108 | 60315 | ||
| WordPress Backups | 71830 | 56385 | Barry Von Someron & mrmist | |
| Getting Started with WordPress | 69926 | 55027 | Rami/Eric | |
| Using Themes | 68308 | 58195 | ||
| Roles and Capabilities | 67441 | 53928 | Drew Jaynes | |
| The Loop | 59236 | 49386 | Jason Hoffman | |
| Introduction to Blogging | 58153 | 51628 | Ronnie Burt | |
| Conditional Tags | 57223 | 45998 | Carrie | |
| Hardening WordPress | Dre Armeda | |||
| 2036152 | 1615139 |
If you’d like to adopt and maintain a Codex page, please leave a comment here, stating which one you’d like.
What’s Expected
Here’s what you’ll need to do:
1. Do a complete review of your page and carry out any updates that are necessary. Also, think about what can be removed. On long pages like the Installing WordPress page, we could run some analytics to see what people are clicking on. I’ll give you whatever support that I can.
2. Making sure all the links are cool, not spammy, and link to something that’s a) up-to-date, and b) GPLGPL GPL is an acronym for GNU Public License. It is the standard license WordPress uses for Open Source licensing https://wordpress.org/about/license/. The GPL is a ‘copyleft’ license https://www.gnu.org/licenses/copyleft.en.html. This means that derivative work can only be distributed under the same license terms. This is in distinction to permissive free software licenses, of which the BSD license and the MIT License are widely used examples.-compliant
2. Review your page whenever WordPress is updated to make sure it’s up-to-date
3. Keep an eye on the History and the Discussion pages for your page to stay aware of any changes or issues.
It’s quite possible that these pages will end up in a handbook or elsewhere, but until that time they could do with some ongoing oversight and <3
Getting Started with WordPress
Yes, yes, I realise we have 3 pages that are pretty similar:
- First Steps with WordPress
- New to WordPress? Where to Start
- Getting Started with WordPress
Someone could review all three of these pages, see if they’re all necessary, merge the content and create one Getting Started with WordPress page, we can redirect the other two pages there.
Otherwise, please only adopt one page.