Agenda for HelpHub meeting 17 September 2018

The next Documentation Team meeting is scheduled on

Monday, September 17, 2018, 15:00 UTC

in the #docs channel on Slack.

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

Current Projects Updates:

  1. Codex Migration (DevHub) – @atachibana
  2. DevHub – @drewapicture & @coffee2code
  3. HelpHub – @kenshino
  4. Inline Docs – @drewapicture & @atimmer

Documentation Team’s handbook

  • We’ll check on the progress of Docs Team’s handbook improvements

Open Floor

Feel free to comment if you have items to add to the agenda.

Documentation Team Handbook Structure Proposal

For a long time our Handbook was almost completely useless for new contributors. It’s half empty and yet full of outdated information. We want to fix this. It won’t be easy and it needs much more than just a content update. It needs complete refactoring. And we need to change our perspective and treat it as one of our ongoing projects.

Refactoring progress is tracked in Trello board. This board is public and you are welcome to join, leave your comments or just follow the progress. Please note that this board is for refactoring purposes. Once we are done with it, it will be back to only team visible and used for documentation team’s work on Handbook. Contributions to the Handbook will be done through docs trac. Or at least we’ll try to use it.

In Trello board you can find proposed new structure and proposed changes for each page. Please take a look, think about its usability and how intuitive it is from the new contributor’s perspective and let’s discuss it on one of coming up docs meetings.

Proposed structure:

This marks following pages for removal:

Empty pages:

Unclear pages:

Outdated pages:

Merged to other pages:

Agenda for HelpHub meeting 3 September 2018

Hello all,

Next HelpHub meeting will happen on

Monday, September 3, 2018, 15:00 UTC
  1. Attendance
  2. Phase 1 Updates (if any)
  3. Phase 2 discussion
  4. Bug Scrub
  5. AOB

Helpful Links

  • HelpHub Staging – https://wp-helphub.com/
  • GitHub repo – https://github.com/kenshino/helphub
  • State of HelpHub (read for Phase 2) – https://make.wordpress.org/docs/2018/02/26/state-of-helphub-february-2018/

Summary for HelpHub meeting 20 August 2018

Attendance

@atachibana @tomf @kenshino @mapk @kafleg @tomjn @felipeelia @milana_cap

Phase 1 Updates

Last #meta meeting didn’t happen and we are still waiting for reply from them.

Phase 2 discussion

@tomf needs help in finding code for Contributor feedback functionality. We want to replicate functionality from Code Reference for start.

We need response from @mapk on new WordPress Version page design suggestion – https://github.com/Kenshino/HelpHub/issues/245

Bug Scrub

These will be reviewed and merged by @kenshino:

https://github.com/Kenshino/HelpHub/pull/252
https://github.com/Kenshino/HelpHub/pull/253

Assigned issues:

https://github.com/Kenshino/HelpHub/issues/214 Assigned @milana_cap
https://github.com/Kenshino/HelpHub/issues/229 Assigned @felipeelia
https://github.com/Kenshino/HelpHub/issues/230 Assigned @felipeelia
https://github.com/Kenshino/HelpHub/issues/236 Assigned @mapk

Help wanted:

https://github.com/Kenshino/HelpHub/issues/231
https://github.com/Kenshino/HelpHub/issues/232
https://github.com/Kenshino/HelpHub/issues/237

On hold:

https://github.com/Kenshino/HelpHub/issues/233 For now keeping open.
https://github.com/Kenshino/HelpHub/issues/254 No for now, but we still want recognition for contributors.

Closed:

https://github.com/Kenshino/HelpHub/issues/250 Duplicate of 229.

Theme Versioning discussion:

https://github.com/Kenshino/HelpHub/issues/258

You can view the meeting history in detail at:
https://wordpress.slack.com/archives/C02RP4WU5/p1534777236000100

Agenda for HelpHub meeting 20 August 2018

Hello all,

Next HelpHub meeting will happen on

Monday, August 20, 2018, 15:00 UTC
  1. Attendance
  2. Phase 1 Updates (if any)
  3. Phase 2 discussion
    • Let’s pick up discussion from last week!
  4. Bug Scrub
  5. AOB

Pinging @kenshino @atachibana @jon_bossenger @karys @nlarnold1 @greensteph @sarassassin @bethannon1 @juhise @sergeybiryukov @bravokeyl @quitevisible @ankitguptaindia @anevins @justingreerbbi @carl-alberto @geoffreyshilling @normalize @hardeepasrani @danhgilmore @wizzard_ @cristiano.zanca @tacoverdo @lumberhack @krogsgard @clorith @versatility @mapk @netweb @milana_cap

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

Helpful Links

  • HelpHub Staging – https://wp-helphub.com/
  • GitHub repo – https://github.com/kenshino/helphub
  • State of HelpHub (read for Phase 2) – https://make.wordpress.org/docs/2018/02/26/state-of-helphub-february-2018/
  • Documentation Team meeting minutes – https://make.wordpress.org/docs/2018/08/12/summary-for-helphub-meeting-6-august-2018/

Summary for Documentation Team Meeting 13 August 2018

Attendance

@kenshino @kafleg @joyously @kartikshukla @tomf @jeroenrotty @mapk @milana_cap @atachibana @jesseowens @felipeelia @netweb @daveryan attended

Codex Migration (for DevHub)

The migration effort is being tracked via Trello and a Google Sheet. The board is now public and quite a few people voiced interest in helping to finish up the migration for DevHub.

@atachibana is leading the effort and revising the list of contributors so new contributors can actually pick up where things stopped.

A “How to contribute” post is being written @atachibana

DevHub

We’ll have to catch up with @drewapicture and @coffee2code in the next Doc meeting to get updates.

HelpHub

As we’re not any closer to merging Phase 1 in, @kenshino will be joining the Meta team meeting that week

Inline Docs

We’ll have to catch up with @atimmer and @drewapicture in the next Doc meeting to get updates.

Documentation Team Handbook

@milana_cap has created a Trello board to track this effort and has made this public.

She also has a few proposals on the board that she’s looking to get comments on before the next meeting so that the team can decide on it then.

Open Floor

@jeroenrotty will be representing Docs Team at WordCamp Brighton

The badge list for all team members and contributors were submitted and is being processed.

You can view the meeting history in detail at https://wordpress.slack.com/archives/C02RP4WU5/p1534172411000471


Agenda for Documentation Team meeting 13 August 2018

The next Documentation Team meeting is scheduled on

Monday, August 13, 2018, 15:00 UTC

in the #docs channel on Slack.

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

Current Projects Updates:

  1. Codex Migration (DevHub) – @atachibana
  2. DevHub – @drewapicture & @coffee2code
  3. HelpHub – @kenshino
  4. Inline Docs – @drewapicture & @atimmer

Documentation Team’s handbook

  • We’ll check on the progress of Docs Team’s handbook improvements

Open Floor

Feel free to comment if you have items to add to the agenda.

Summary for HelpHub meeting 6 August 2018

Attendance

@atachibana @kafleg @mapk @polkadotcreation @jesseowens @audrasjb @jeroenrotty @chetan200891 @kenshino @tomf @tomjn @joyously @felipeelia @kartikshukla attended

Phase 1 Updates

Still no concrete updates from Phase 1. @kenshino will be pinging the meta team and likely joining the meta team meeting to push this forward.

Phase 2 Updates

@audrasjb migrated the remaining pages onto HelpHub staging and has been working on template enhancements

We’ve created an issue to track linking WordPress versions from DevHub – https://github.com/Kenshino/HelpHub/issues/257

@audrasjb and @atachibana are working on improving the content format of the WordPress Version pages so that users and developers can get information relevant to them immediately.

@tomjn is working on Gutenberg functionality for HelpHub

@tomf is going through Contributor feedback functionality

You can view the meeting history in detail at https://wordpress.slack.com/archives/C02RP4WU5/p1533568123000526

Agenda for HelpHub Meeting 6 August 2018

Hello all,

Next HelpHub meeting will happen on

Monday, August 6, 2018, 15:00 UTC
  1. Attendance
  2. Phase 1 Updates (if any)
  3. Phase 2 discussion
    • Let’s pick up discussion from last week!
  4. Bug Scrub
  5. AOB

Pinging @kenshino @atachibana @jon_bossenger @karys @nlarnold1 @greensteph @sarassassin @bethannon1 @juhise @sergeybiryukov @bravokeyl @quitevisible @ankitguptaindia @anevins @justingreerbbi @carl-alberto @geoffreyshilling @normalize @hardeepasrani @danhgilmore @wizzard_ @cristiano.zanca @tacoverdo @lumberhack @krogsgard @clorith @versatility @mapk @netweb @milana_cap

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

Helpful Links

  • HelpHub Staging – https://wp-helphub.com/
  • GitHub repo – https://github.com/kenshino/helphub
  • State of HelpHub (read for Phase 2) – https://make.wordpress.org/docs/2018/02/26/state-of-helphub-february-2018/
  • Documentation Team meeting minutes – https://make.wordpress.org/docs/2018/08/06/summary-for-documentation-team-meeting-30-july-2018/

Summary for Documentation Team Meeting 30 July 2018

Attendance

@kenshino @atachibana @drewapicture @atimmer @milana_cap @audrasjb @wizzard_ @felipeelia

Codex Migration (DevHub)

@atachibana has picked up from @drewapicture to finish up the Codex Migration for articles relating to DevHub

Key factors that we look into while migrating

  1. What is relevant to developers
  2. What’s not longer relevant (because we only support stable WP in the code reference)
  3. What’s just plain wrong and needs to be stripped out

The work progress is being tracked via a Google Sheet

DevHub development

@coffee2code is responsible for DevHub’s development road map and @drewapicture is catching up with him to implement auto-approving for the feedback mechanism for authors that have had sustantial suggestions previously approved

HelpHub

We’ve been ready to launch for a little more than 1 month but it’s been stuck in limbo because of WordPress.org ‘s media upload restrictions.

There are only a few people who can directly upload the media files to the CDN and then we’ll still have to run the importer to get the content in (without dealing with uploads)

The media files to CDN thing is in an unclear state. But the content work is being looked at by Dion.

@kenshino will catch up with @coffee2code to look into the CDN issue.

A draft post to announce the launch of HelpHub and the deprecation of Codex is being planned.

Inline Docs

@sergeybiryukov has taken over most of @drewapicture‘s duties for inline documentation.

The Yoast team has been working hard on all core admin JS inline documentation.

The Docs team has invited @atimmer to join Docs Team meetings to update on JS inline documentation proceedings.

Docs Team Handbook Structure

The Docs Team spends a lot of time creating docs all over the WordPress ecosystem but ends up not being able to improve our own internal handbook.

The official Docs Team Trello group is at https://trello.com/wordpressdocs and we have setup the Docs Team handbook restructure board at https://trello.com/b/1NtDI3lb/docs-team-handbook

@milana_cap is in charge of this project so please ping her if you’re interested to help make the Docs  Team’s documentation better 🙂

Feedback for Docs Team handbook

We’ve decided to adopt the use of https://docs.trac.wordpress.org/ to allow the public to give feedback on the Docs Team handbook.

This allow us to

  • Attribute accountability
  • Tie into Slack notifications
  • Tie into WordPress.org accounts

We might consider using that for more areas but we’ll take one step at a time!

Next Meeting

The next Docs Team meeting will be on 13 August Monday. This week (6 August), we’ll be having the HelpHub meeting at 15:00 UTC.

You can view the meeting history in detail at https://wordpress.slack.com/archives/C02RP4WU5/p1532931128000012