Meeting notes #docs office hours 3 12 regarding…

Meeting notes #docs office hours 3/12 regarding THB

  1. Discussed how the THB has great content, but starting at Ch. 3: Theme Functionality until the end of the THB, many sections need more explaining and work to be user friendly for new theme developers and to match the tone started in the first two chapters
  2. Actionable items will be added to pages that need updating. Standardized from here out users creating notes in spreadsheet will include their name and the date of the note to assist in the process.
  3. Inconsistencies between linking to outside references versus including all content within the THB were discussed. A decision was reached to keep everything internal and remove links to The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. sites.
    • The problem of long pages was discussed in moving everything internally and the solution was provided to expand/contract code references. @siobahn will create a ticket.
  4. The difficulties in having both a tutorial and reference combined in one handbook was discussed and 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. solution to wrap tutorial sections in was decided upon.
    • The styling will be light purple with a hammer dashicon @samuelsidler is creating the ticket
    • Users will be able to hide or expand all future tutorial sections based on their needs
    • Additionally, pulling out the entire tutorial into one combined page/section should be available with the use of the shortcode.
  5. To assist users in the tutorial, hyperlinks to previous tutorial sections will be provided in each new section for users that are jumping in mid process.
  6. A slimmed down version of twenty fifteen theme was decided upon to be the theme built in the THB. Someone to simplify twenty fifteen has yet to be determined
  7. New tasks will be added to spreadsheet that encompass overall goals to be completed by one or two people for the sake of consistency.

Action items:

  • Rename titles in spreadsheet – @lizkaraffa
  • Add notes for problem pages with name/date – @lizkaraffa
  • Change percentages of completion – @lizkaraffa
  • Create overall tasks for THB in spreadsheet – @lizkaraffa
  • Slim down twenty fifteen theme for final theme – ?
  • Ticket to expand and contract reference code @siobhan
  • Ticket to create tutorial shortcode – @samuelsidler


Okay everyone Here is the agenda for today’s…

Okay everyone, Here is the agenda for today’s THB discussion during docs office hours.

Overall state of THB

Overview of Inconsistencies

  • Somewhat opposing jumps between tutorial and reference guide
  • Linking to resources externally or keeping it within

Tutorial Sections

Problem pages


There’s not a whole lot happening in docs…

There’s not a whole lot happening in docs at the minute so how about folding the Handbooks chat in with the docs chat and having a regular docs chat on Thursdays from 18:00 – 19:00 UTC?


Today’s Docs Office Hours

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!


Docs Office Hours Agenda

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


No Office Hours This Week

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

See everyone next week! 🙂


No Office Hours Today

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