Summary for Documentation Team Meeting February 16

 

Attendance

@drewapicture @Kenshino @desrosj @hardeeparsani @cais @milana_cap @kafleg @mrahmadawais @juhise

Change of timing

We moved the meeting forward this time due to conflicting schedules. Apologies to those who were thinking attending it at the original timing.

We are perhaps thinking of moving it up 2 hours to 2017 15:00 UTC. What do you think?

General Updates

  • Helphub is moving ahead slowly.
  • Theme Developer Handbook was released
  • DevHub comments / code suggestions clearing is going too slow (@drewapicture will help to clear)

WordPress Community Summit 2017

The community summit will be held in conjunction with WCEU this year in Paris. The last time it was held alongside WCUS in Philadelphia in 2015.

The summit will be held June 13-14, preceding WCEU, June 15-17.

The Community Summit is less like an actual contributor day and more of an opportunity to discuss and make decisions and plans for your respective teams.

Typically, for instance, you’ll see the core team make roadmap-related decisions about what’s coming up in core development for the next two years. Talk about priorities, active projects, projects you want to work on, Very much like a retreat.

The Docs team launched the Plugin Developer Handbook, for instance during the San Franciso Summit in 2014

It usually proves to be very productive for every team that meets and has a presence. It’s also an opportunity to have discussions with other teams, especially for discussing cross-team projects like helphub (docs + support + meta), devhub (docs + meta), inline docs (docs + core), etc.

People attending

@kenshino, @drewapicture

People wanting to attend

@zzap, @atachibana

We would love to have more people to attend from the Helphub, Theme Developer and Plugin Developer Handbooks teams. If you are working on a documentation project for WordPress.org, or if you’re a documentation junky who wants to contribute, please let @Kenshino or @drewapicture know that you’re interested.

Attendance to the WordPress Community Summit is through nomination by the Make / WordPress team leads. We can only nominate you if you let us know you’re interested!

We will have to submit this by the end of February. Please let us know by then!

Summit Discussion Topics 

  • Game plan for recruitment
  • Onboarding Plan
    • We get a ton of people wanting to contribute but we have no established recourse for providing that access.
  • State of Doc’s Team (own) documentation
  • DevHub and Helphub translation Mechanism (Docs + Meta + Polyglots)

We would love to cover more in the summit, so please post topic suggestions in the comments!

WP CLI Code/Command Reference

We’ll probably be restarting devhub meetings soon, so for now, I’d say just leave the command docs in control of wp-cli.org and we’ll look at short-term and long-term solutions to bringing those docs over.

The upside of wp-cli command docs is that they’re already written in PHP and use phpdoc to parse into the staticly-generated pages, so we might be able to fork the parser we use for the code reference.

Read the meeting transcript in the Slack archives. (A Slack account is required)

#summary

Helphub Meeting 14 Feb (nope)

Hey Helphub Team,

So our meeting falls on Valentine’s day, therefore, take a break from WordPress and have a great day with your loved ones.

We’ll see you 21 Feb, Tuesday. An agenda will be posted closer to that date.

Lastly, please note that if you’d like to join the WordPress Summit as part of the Docs Team, please check out the Docs meeting ‘s agenda or drop @Kenshino a DM.

Have a great one all!

 

Agenda for Documentation Team meeting Feb 16

Hey,

We’re deeply sorry the bi-weekly chat didn’t happen last week.

Here’s the agenda for the Docs team bi-weekly chat, which are held Thursdays and the upcoming one will be at February 16 2017 17:00 UTC in the #docs channel on Slack.

If we do not get any attendance, open floor will be held instead

This week, we will not be doing any project specific updates, but will focus on some key issues.

  1. General quick updates
  2. WordPress Summit 2017
    • It will be held in conjunction with WordCamp Europe (Paris)
    • The summit itself will be held from 13-14 June
    • Who wants to go to the summit? Nominations for the Doc team is open.
    • What shall we do? We need to work on projects and/or discuss goals & ideas for 2017
    • See https://make.wordpress.org/summit/2017/01/26/community-summit-2017/ for more info
  3. WP-CLI Code/Command Reference
    • Where shall these go? See https://meta.trac.wordpress.org/ticket/2465

If you have done any work with any doc related projects or if you are interested in the Documentation Team, you’re invited to join in the meeting.

#agenda

Agenda for Documentation Team Meeting February 9

Here’s the agenda for the Docs team bi-weekly chat, which are held Thursdays at February 09, 2017 17:00 UTC in the #docs channel on Slack.

If we do not get any attendance, open floor will be held instead

This week, we will not be doing any project specific updates, but will focus on some key issues.

  1. General quick updates
  2. WordPress Summit 2017
    • It will be held in conjunction with WordCamp Europe (Paris)
    • The summit itself will be held from 13-14 June
    • Who wants to go to the summit? Nominations for the Doc team is open.
    • What shall we do? We need to work on projects and/or discuss goals & ideas for 2017
    • See https://make.wordpress.org/summit/2017/01/26/community-summit-2017/ for more info
  3. WP-CLI Code/Command Reference
    • Where shall these go? See https://meta.trac.wordpress.org/ticket/2465

If you have done any work with any doc related projects or if you are interested in the Documentation Team, you’re invited to join in the meeting.

Agenda for HelpHub design meeting February 7

Hello!

Time/date: Tuesday, February 7, 2017, 15:00 UTC in #docs

  1. Attendance
  2. Progress on Tasks
  3. AOB

You can find the main Helphub meeting’s agenda here.

Pinging @krogsgard @versatility @mapk @wizzard_

If I have missed any usernames, it’s not on purpose and do consider yourself invited to the meeting.

#agenda

Agenda for Helphub Meeting February 7

Hello!

Sorry I missed the last meeting. It was a tight few days at work and I totally lost track of which day it was of the week.

Time/date: Tuesday, February 7, 2017, 14:00 UTC in #docs

  1. Attendance
  2. Migration Updates
  3. Design Updates
  4. Development Updates
  5. AOB

Pinging @atachibana @jon_bossenger @karys @nlarnold1 @greensteph @sarassassin @bethannon1 @juhise @hlashbrooke @sergeybiryukov @bravokeyl @quitevisible @ankitguptaindia @anevins @justingreerbbi @carlalberto @geoffreyshilling @normalize @hardeepasrani @danhgilmore @wizzard_ @cristiano.zanca @tacoverdo @lumberhack @krogsgard @clorith @versatility @mapk

If I have missed any usernames, it’s not on purpose and do consider yourself invited to the meeting.

#agenda

Agenda for Helphub Design Meeting 24 Jan

Hello!

Time/date: Tuesday, January 24, 2017, 15:00 UTC in #docs

  1. Attendance
  2. Progress on Tasks
  3. AOB

You can find the main Helphub meeting’s agenda here.

Pinging @krogsgard @versatility @mapk @wizzard_

If I have missed any usernames, it’s not on purpose and do consider yourself invited to the meeting.

#agenda, #design

Agenda for Helphub Meeting Jan 24

Hello!

Time/date: Tuesday, January 24, 2017, 14:00 UTC in #docs

  1. Attendance
  2. Migration Updates
  3. Design Updates
  4. Development Updates
  5. AOB

Pinging @atachibana @jon_bossenger @karys @nlarnold1 @greensteph @sarassassin @bethannon1 @juhise @hlashbrooke @sergeybiryukov @bravokeyl @quitevisible @ankitguptaindia @anevins @justingreerbbi @carlalberto @geoffreyshilling @normalize @hardeepasrani @danhgilmore @wizzard_ @cristiano.zanca @tacoverdo @lumberhack @krogsgard @clorith @versatility @mapk

If I have missed any usernames, it’s not on purpose and do consider yourself invited to the meeting.

#agenda

Summary for Helphub Meeting Jan 17

Migration Updates

23 articles left to get through with basic re-writes.

All work should be documented on Trello

Design Updates

As the design meeting was postponed due to schedule conflicts, there were no updates this meeting.

Development Updates

There are a total of 17 open issues still, most of which have to do with front end design that require decisions to be made by the Helphub design team.

Open Floor

Category Editors

There are only 2 category editors still, @normalize for ‘Getting Started’ and @atachibana for ‘Security’, we need some of the key editors that have been working on the project to take up the mantle.

Read the meeting transcript in the Slack archives. (A Slack account is required)

#summary

Theme Developer Handbook released

After around close to 2 years of development, through a total of 3 different teams, we have released the Theme Developer handbook, thereby completing the Developer Hub’s goal of having proper developer docs for the main aspects of WordPress.

This could not have happened without a few of the initial leads and project pushers – @siobhan, @samuelsidler @sewmyheadon @lizkaraffa @thoronas @jcastaneda @grapplerulrich @anthonynotes @topher1kenobe.

The list of people involved (not yet complete) is documented here and last count puts us at close to 100 people involved in the handbook in one way or another.

The handbook has been released in it’s version 1 form and is updated all the way to 4.7.

There’s always more to do and the team continues to manage and improve the handbook on Trello.

Please do give us feedback using the methods detailed here.

We hope this helps everyone make better themes!

Get cracking at https://developer.wordpress.org/themes/

Props to the editors who came in after the handbook progress stalled for awhile @kenyasullivan @xfrontend @burlesonbrad @nao @jacobmc @hardeepasrani @sheebaabraham @boogawooga @rahulsprajapati @viniciuslourenco @kafleg @atachibana @sarahovenall @sushil-adhikari @celloexpressions @juhise

+make.wordpress.org/themes