The Codex went read-only a few minutes ago, for a MediaWiki upgrade. I’ll update this post in a few minutes when the upgrade is complete.
Tagged: codex Toggle Comment Threads | Keyboard Shortcuts
I’ve made a list of all of the things in the codex that I think need to be updated for WordPress 3.5: https://make.wordpress.org/docs/2012/11/27/if-all-goes-to-plan-wordpress-3-5-will/
It’s in progress so please feel free to add to it.
But what’s most relevant, is that some of the updates will be relevant to the user manual too. We’re already aware of the updates to media, but there have been a number of changes to the Settings as well. I’m not sure if they were considered when we created the manual.
During our regular meeting in IRC we discussed some changes to the codex, based on the roundtable discussion at the WordPress Community Summit.
Before we started ripping things apart, I thought it would be good to look at some stats, if possible, and also to get community input. Because it’s one thing to come up with a good idea, but it’s another to make sure that’s what is needed based on numbers and user feedback.
So this is basically our gut check.
To that end, here are the top 40 visited Codex pages in the last month or so:
And for perspective, the top page (function reference) got over 1.9 million hits, while the second page was hit only 280,000 times.
To me this backs up our earlier conclusion of a divide between users and devs and where they go and what they look for. So the user handbook will likely be well received. Ipstenu made us a shortcode for the Codex so we can start marking pages that will considered for removal and send users to the user manual instead.
The other thing we talked about, before we go too far, is to create a poll to get feedback on codex reorganization.
Some suggested poll items:
- I like the codex just as it is, it need some love!
- separate user docs from dev docs
- something else
Your suggestions for poll options are welcome! Without it turning into an actual poll here…
We should probably get a conversation going not only about needed Codex work but *how* to approach a better structure and how to get the work done.
I’m leaning towards a re-org and maybe a bit of a division between users docs and programmer notes. A good example of this the Pages page. It starts out as a user doc then jumps right into code.
Things like Handbooks need to be sorted out and linked to as well.
I think if we could sort out the right approach first and focus on specific pages or topics later, then we’d start making big progress. Possible if we even approached it like a WP dev cycle, with clear targets and a deadline.
Possibly a mentorship program as well, wehre we could round up people to help and start handing out assignments and being there to keep people on task and for any questions they have.
All thoughts welcome here.