Siobhan 11:47 pm on April 9, 2013
Tags:   

Adopt a Codex Page

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.

#codex