Kim Parsell

Welcome to the official home of the WordPress Documentation Team.

This team is responsible for coordinating all documentation initiatives around WordPress, including the handbooks and other general wordsmithing across the WordPress project.

Want to get involved?

Start here to find out more about what we do and how to contribute:

Onboarding to Documentation Team: An overview of what we do and how to collaborate
Documentation Issue Tracker on GitHub: Submit any Documentation Team-related issues on GitHubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/

Weekly meetings

Join our discussions of documentation issues here on the blog and on Slack.

The documentation team holds weekly office hours and monthly Contributor Days on each Tuesday of the month in the #docs SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. channel. It’s also where you can contact the team at any time outside meetings.

We’ll be holding office hours at our normal time today.

This will be the last weekly office hours for the Docs team for 2014. The next two Thursdays are both holidays, so the next time we get together will be on January 8, 2015. That will also be our monthly team chat, so mark your calendars. 😉

Hope to see you there!

#office-hours

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/CoreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. 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

CustomizerCustomizer Tool built into WordPress core that hooks into most modern themes. You can use it to preview and modify many of your site’s appearance settings. APIAPI An API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways. 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 – HeaderHeader The header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes. and Background menu items now link directly to the Customizer.

#4-1, #codex, #handbooks

There are a few things we need to discuss that were brought up in core dev chat yesterday:

Documentation from various make/coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. posts need to go into the plugin handbook and theme handbook.
4.1 Codex updates
4.1 version page

Please plan on attending office hours at 18:00 UTC.

See you there! 🙂

#office-hours

Due to a scheduling conflict, today’s Inline Docs chat has been cancelled.

See everyone next week!

#inline-docs

We won’t be having our regular team office hours tomorrow due to the Thanksgiving holiday.

See everyone next week! 🙂

#office-hours

Per @samuelsidler, there will be no Devhub chat this week.

Next chat will be Tuesday, 11/11/2014 at 20:00 UTC.

#devhub

With the end of Daylight Savings Time in the US this past weekend, we decided to make the UTC times for the weekly meetings one hour later to keep the meeting times the same in each team member’s timezone.

The chat times in the sidebarSidebar A sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme. have been adjusted to reflect this change, as well as the appropriate SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. channel added for each chat.

#chat

The following is the final list of goals for our team meetupMeetup All local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area. after WCSF, and the agenda for the two day meetup:

1. Goals

Handbooks:

Work on completing unfinished sections.
Review existing content for accuracy/proper voice; make necessary edits.
Review code snippets to ensure they’re correct.
Fix all Codex links to point to proper handbook or code reference page.
Fix any function/hook/class references to be the right format and linked to the code reference.
Ensure screenshots are on devhub instead of make/docs.
Take handbooks public.

Support Hub:

Spend time with Support team discussing ideas for new Support Hub (continue discussion from the proposed community summit topic).

2. Agenda

Tuesday

10:00 – Welcome and discussion of goals
10:15 – Assign work
10:30 – Work
13:00 – Lunch
14:00 – Back to work
16:00 – Discussion with support team
18:00 – Finish work for the day

Wednesday

10:00 – Work
13:00 – Lunch
14:00 – Work
17:00 – Finish work, review what goals were met
18:00 – Close out team meetup

#meetup, #wcsf

Since most of us are preparing to travel tomorrow, there won’t be any Docs Office Hours today.

#office-hours

We’ve made plans to work on completing both the developer handbooks during our two day team meetupMeetup All local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area. following WCSF.

I’d like to use this thread to discuss ideas on what Docs tasks we can have contributors work on during Contributor DayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/. on Sunday.

This is a good opportunity to have contributors work on non-handbook tasks that also need to be completed.

A couple possibilities are:

Code Reference MigrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies.: migration of content from the Codex code references to the new code reference, including reviewing content, adding examples, and setting up redirects from the Codex.
Codex cleanup: review of Codex content – editing, truncating, deleting pages that are out of date.

If you have other suggestions, please add them in the comments. Also indicate whether you’ll be available to work with new contributors on Sunday.

#contributor-day, #wcsf2014

Want to get involved?

Weekly meetings

Author Archives: Kim Parsell

Today’s Docs Office Hours

4.1 Docs Updates

Handbooks:

Codex Updates:

Docs Office Hours Agenda

No Inline Docs Chat Today

No Office Hours This Week

No Devhub Chat Tomorrow

Weekly Chat Times

WCSF Team Meetup Goals/Agenda

No Office Hours Today

WCSF Contributor Day