Codex chat

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:

/Function_Reference/
/Installing_WordPress,
/Template_Tags/,
/Version_3.4.2,
/First_Steps_With_WordPress,
/Class_Reference/,
/Editing_wp-config.php,
/Main_Page,
/Plugin_API/,
/Theme_Development,
/Using_Permalinks,
/Pages,
/WordPress_Lessons,
/Glossary,
/New_To_WordPress_-_Where_to_Start,
/Moving_WordPress,
/Giving_WordPress_Its_Own_Directory,
/Changing_File_Permissions,
/Child_Themes,
/WordPress_Backups,
/Getting_Started_with_WordPress,
/Using_Themes,
/Create_A_Network,
/Changing_The_Site_URL,
/Roles_and_Capabilities,
/Introduction_to_Blogging,
/The_Loop,
/Blog_Design_and_Layout,
/Conditional_Tags,
/Using_Custom_Fields,
/Formatting_Date_and_Time,
/Function_Reference,
/WordPress_in_Your_Language,
/Template_Hierarchy,
/Creating_a_Static_Front_Page,
/Post_Types,
/Writing_a_Plugin,
/Template_Tags,
/Excerpt,
/Updating_WordPress,

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… 😉

#chat, #codex

Again with a meetup

The awesome Jerry is taking on Gravatars because it fits with the user section he has just completed.

HTTPS is still up for grabs.

Some proofreading going on and we’re wondering if we can un-techie “install on your own server” for newbies. Maybe soften it to “your web host”.

Jerry has moved “your Profile” from chapter 7 and put it under “Managing Users on your WordPress Site” in Ch06.

Also we noted about being careful with internal linking in the manual, depending on final home.

Fastest meetup ever! There were only 3 of us.

Chat for this weekend is cancelled See you…

Chat for this weekend is cancelled. See you next week!

Meeting recap

We had our first ever IRC chat today at 1800 UTC in #wordpress-sfd. Since this was our first ever, we mainly clarified a few things and went over projects in progress.

For the post below about editing pages ported in from WordPress.com, no one present was actively working on any specific pages. We should probably group them out somehow and assign or volunteer for those, so we know who is working on what, and so we’re not tripping over each other and duplicating work.

I suggested a mentorship drive at pretty much the same time Siobhan did, so look for a post about that soon.

Jane popped in and suggested that our two pages listed support might want to be tweaked. The page for the handbook on how to contribute for support personel is one, and the https://make.wordpress.org/support/handbook/ should maybe be renamed to current projects or just Projects, since it’s going to be moved anyway.

My apologies if I missed anything. The chat log can be accessed here.

Codex work

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. 🙂

#codex, #docs

Standard responses

In order to get the ball rolling, how about we all chime in with our most-use responses?

Some tools you may wish to use to make answering posts easier/faster:
TextExpander
Popcrom
Lifehacker list of alternatives for Macs

Please feel free to use and adapt these to your own needs. Personally, I find it nicer for the users if each mod has a slightly different phrase. 😉 Otherwise, we’re just support bots. 😀

#advice, #responses