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,
/ExcerptExcerpt 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.,
/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 shortcodeShortcode 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… 😉

#chat, #codex

Chat Recap – Aug 30

We did a lot in an hour!
Handbook Changes

The ‘user handbook’ is now at https://make.wordpress.org/support/user-handbook/

However this is temp! We’re going to build out at https://make.wordpress.org/support/user-manual/ starting with a more clear Table of Contents. Once we have that done, we can bring pages over one at a time. In the mean time, edit in https://make.wordpress.org/support/user-handbook/ and when you’re done tag the page (oh yes, we haz tags!)

We’re going to try to split the handbook into ‘weeks’ with the goal of being done by WPCS. So two months! (possibly get this so it can be used by https://wordpress.org/extend/plugins/wp-help/ or something similar for end users on their own WP installs?)

Week One: TOC! Let’s sort out the best way to present the basic info.

Please go to https://make.wordpress.org/support/user-manual/ and weigh in (yes, comments r good). We’re not doing a straight copy-over, but as we find pages that are relavent, we’ll sort ’em that way. Come up with what sub-topics we should have in each section. We’re trying to KISS, so think of the least technical person you know and start there. Where would they start.

The TOC will drive the next weeks topics.

Mod Handbook

The mod handbook – https://make.wordpress.org/support/handbook/ – needs your love too.

Misc.

  • More Mods – suggestions? Comment or if you want to be private, pingPing The act of sending a very small amount of data to an end point. Ping is used in computer science to illicit a response from a target server to test it’s connection. Ping is also a term used by Slack users to @ someone or send them a direct message (DM). Users might say something along the lines of “Ping me when the meeting starts.” me.
  • Ditto being an editor here. Just ask. As long as you have a decent track/tracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub.https://core.trac.wordpress.org/. record, I see no problems.
  • Sending bump-a-holics to IRC – https://codex.wordpress.org/IRC
  • Embed IRC in a page? http://webchat.freenode.net/
  • bbPressbbPress Free, open source software built on top of WordPress for easily creating forums on sites. https://bbpress.org./BuddyPress docs need lurve too!

Nacin List

@nacin’s to do 😉

  • Why no GUI editor? (@Ipstenu)
  • Tags on pages (admin only)
  • List pages by tags so people can see what needs doing

Wish List

Things @ipstenu needs to harangue @otto42 about.

  • One click to blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience./delete posts on the forums (for spammers)
  • Hover over tags and see who added it?
  • Can we add this above the new topic field? “Please disable or delete all plugins and switch to the default theme (Twenty Ten since 3.0). After making these changes does the problem still occur? If no, re-enable everything one by one to see which component causes the problem.”

#chat, #write-up