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:
/Excerpt An excerpt is the description of the blog post or page that will by default show on the blog archive page, in search results (SERPs), and on social media. With an SEO plugin, the excerpt may also be in that plugin’s metabox.,
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 A shortcode is a placeholder used within a WordPress post, page, or widget to insert a form or function generated by a plugin in a specific location on your site. 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… 😉