Emoji in the Codex!

Currently the new emoji in WordPress 4.2 aren’t documented anywhere. I found this very confusing when trying to figure out how to use them. This is a great time to get rid of the old Using Smilies page and have a new user-facing emoji page.

This needs to be done asap so we can include a link to it in the new release.

The page should contain the following:

1. Short intro to emoji
2. Short section on emoji on mobile
3. Short section on emoji on desktop (including the shortcuts on each platform to bring up the emoji popup)
4. List of common emoji/smilies

Anyone interested in volunteering? We need it pretty quickly so we can add a link to it in 4.2.

#codex

@kpdesign has been working day and night to…

@kpdesign has been working day and night to get the 4.1 version article filled up leading up to this week’s release. She could really use some help getting it into shape.

In particular, the Under the Hood section could use a bit of work by folks who have more intimate knowledge of core. These would be people like @ipstenu, @sewmyheadon, @dh-shredder, @boonebgorges and others who have helped out in the past.

If you think you know someone from the core team who could lend a hand, please please point them this way.

Some items may also need to simply be reorganized from section to section. Any and all help would be greatly appreciated.

We’re primarily working off of two checklists:

Anything checked off has already been added to the version page in some form, or skipped for brevity.

#codex, #core, #release, #sprint

4.1 Docs Updates

There are a number of updates that need to be made for 4.1 to both the handbooks and the Codex.

Handbooks:

There are several posts on Make/Core about changes in 4.1 that affect the developer handbooks:

Themes: New Template Tags in 4.1

Queries Improvements:

Shared Terms: An Update on Shared Term Splitting

Customizer API Improvements: JS/Underscore-template-rendered Custom Customizer Controls in WordPress 4.1

I still need to add a list of Codex pages here that will need to be updated with the content from these posts.

Codex Updates:

The following are the pages that need updated or created in the Codex.

If you would like to help, please leave a comment indicating which page you would like to work on.

New default theme:

  • Twenty Fifteen page. We can use some of this content. Note: The custom color screenshots are slightly different from the .org version. Takashi Irie provided some screenshots that reflect the default colors available: https://cloudup.com/cNHOeJVOq-k (@kpdesign)

New features:

  • New Distraction-Free Writing and inline image editing toolbar in Post editor – https://codex.wordpress.org/Posts_Add_New_Screen and https://codex.wordpress.org/Pages_Add_New_Screen
  • New sessions logout button on Profile page – https://codex.wordpress.org/Users_Your_Profile_Screen
  • New Recommendations tab on Plugin Install page – https://codex.wordpress.org/Plugins_Add_New_Screen
  • New translation installation setting on General Settings and Network Settings pages – https://codex.wordpress.org/Settings_General_Screen and https://codex.wordpress.org/Network_Admin_Settings_Screen
  • Appearance menu – Header and Background menu items now link directly to the Customizer.

#4-1, #codex, #handbooks

All Hands on Deck for the 4.0 Version Article

For most of today and part of tomorrow, my efforts will largely be focused on fleshing out the Codex version article for the 4.0 release.

We’ll be combing through some of the (older) This Week in Core posts on make/core, the About page content, as well as the bug and enhancement/task changesets.

Working on the version article is also an excellent opportunity to start building a Codex sprint list for the coming release.

If you’d like to help out with either effort, we could certainly use you. Even if you only have 30 minutes to spare, every little bit helps. I’ll be hanging in the #wordpress-sfd channel on IRC all day today, so feel free to jump in.

#4-0, #codex

WordPress 3.9 Codex Updates

I’ve made a start on the Codex updates list. Feel free to add to it.

I don’t think we’ll have a huge number of updates this time around.

User

Widgets:

  • WordPress Widgets: https://codex.wordpress.org/WordPress_Widgets

Uploading Images:

  • Using Images: https://codex.wordpress.org/Using_Images (suggest a complete rewrite)

Media Editing:
(now available in the modal window and with some other tweaks)

  • Edit Media: https://codex.wordpress.org/Edit_Media
  • Inserting Media into Posts and Pages: https://codex.wordpress.org/Inserting_Media_into_Posts_and_Pages (@designsimply)

Galleries:

  • The WordPress Gallery: https://codex.wordpress.org/The_WordPress_Gallery

Audio and Video Playlists:

  • Inserting Media into Posts and Pages: https://codex.wordpress.org/Inserting_Media_into_Posts_and_Pages

TinyMCE:

  • Writing Posts: https://codex.wordpress.org/Writing_Posts

New page needed:

  • WordPress Theme Customizer (user-facing)

Developer

TinyMCE:

  • TinyMCE https://codex.wordpress.org/TinyMCE

Theme Customizer:

Miscellaneous:

  • New arguments added to paginate_links() in r27600 (#24709): https://codex.wordpress.org/Function_Reference/paginate_links (@grahamarmfield)

Deprecated Stuff:

#codex

Need a volunteer to help prepare for Codex updates

WordPress 3.9 is arriving next week, which means that we need to get the codex updated. It helps to have a master list of pages in the codex that need to be updated, like this one here. We’re looking for a volunteer (or volunteers) to compile this list.This involves:

1. Listing all of the new features, functions, etc in a P2 post. The 3.9 Codex page has many of them.
2. Finding all of the pages in the Codex that need to be updated to reflect the changes in WordPress and listing them. (You can create a checklist by putting a o at the start of a link in P2.)

This helps a lot with keeping track of what’s done and what needs to be done.

Anyone interested?

#codex

Looking for a volunteer to add a …

Looking for a volunteer to add a “Stopwords” section to Translating WordPress > Types of Messages in the Codex.

Relevant information can be found in the ticket description for #26670.

#codex

Codex: Editing wp-config.php Page Reorganization

mrmist posted the following to the wp-docs mailing list earlier this AM:

The Codex page https://codex.wordpress.org/Editing_wp-config.php is really long.

I wonder if it should be broken out into basic wp-config and more advanced stuff. Where “basic” would just include things that your average user might need.

Currently the “Advanced” stuff occupies the mass of this page, and makes it much longer and more daunting looking than it needs to be.

Also, if we restrict the main bulk of the page to the very basics, it could have edit protect enforced on it and prevent people posting their database credentials to it.

Thoughts, etc…

mrmist

I agree with him – the whole page should be reorganized and updated. Thoughts on splitting it into 2 pages – original with the basic information, and a second page for the advanced information?

#codex

Codex Spam

Per @mrmist, we seem to have a glut of spammers on the Codex, creating fake user profile pages with mini biographies containing spam links at the bottom. Each fake profile is then creating a spam page, or editing an existing page to introduce spam links.

Please be on the look out and either delete if you can, or replace the page with {{rfd}} otherwise.

#codex

The Codex survey is closed and the next…

The Codex survey is closed and the next stage is to go through the responses. We’re going to do this by user type:

  • Drew – Advanced Users
  • Eric – WP Builder & novice dev
  • Siobhan – Intermediate dev
  • Jerry – WP User

Please post your results here by Friday 14th June. We’ll be using the results along with other research that’s been going on to do a workshop on the first morning of the docs sprint.

A few notes for the reviewers:

  • Use the filter at the top to filter by your assigned user group I’ve edited your access so you just get the results for the user group you’re looking at.
  • Remember that if a respondent provides a particularly insightful answer you can click on the report number to the left of their answer and read through that person’s individual report.

If there’s any other questions you feel should be added to the report, let me know in the comments.

Outline for Report

User Type:

Learning preferences (please list in descending order, noting the percentage):

Notable answers listed under other:

Top three places to look for an answer to a question (list in descending order, noting the percentage):

Are there any other places that these users are regularly looking for answers (make sure you check through the “Option option” answers)?

How useful is the Codex to this user group?

What sections of the Codex do these users find most useful?

What are the main problems these users face with the Codex?

What documentation would these users like to see more of?

Based on your review of this survey, do you have any general observations about how this user group is making use of the Codex and documentation more generally?

Based on your review of the survey, what recommendations would you make specifically about the WordPress Codex that would help these users?

Based on your review of this survey, make three recommendations for improved documentation that would serve these users:

Contributing to WordPress Docs

What percentage of these users have contributed to WordPress Docs?

What percentage are aware that they can use their WordPress.org login to edit the Codex?

How can we make it easier for these users to contribute to WordPress docs?

#codex, #survey