Agenda for Documentation Team Meeting 16 July 2018

As discussed in the open floor of the HelpHub meeting previously, the Documentation team meeting will alternate with HelpHub meeting.

I don’t expect a lot of attendance since we’re just restarting but let’s all just get into the momentum!

Monday, July 16, 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) – @drewapicture
  2. DevHub – @drewapicture
  3. HelpHub – @kenshino
  4. Inline Docs – @drewapicture

Other Stuff:

  1. Defining proper Docs Team meeting agenda
  2. Open Floor

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

Agenda for HelpHub Meeting 9 July 2018

Hello all,

Next HelpHub meeting will happen on

Monday, July 9, 2018, 15:00 UTC

in #docs.

As discussed last meeting, we’ll alternate HelpHub meetings with Documentation Team meetings. This week we’ll do HelpHub again with the next being Doc Team’s!

  1. Attendance
  2. Phase 1 Updates (if any)
  3. Phase 2 discussion
  4. 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/
  • Last meeting minutes – https://make.wordpress.org/docs/2018/07/09/summary-of-helphub-meeting-2-july-2018/

Summary of HelpHub Meeting 2 July 2018

Attendance

@pskli @netweb @clorith @milana_cap @atachibana @g.allegretta @kenshino

Phase 1 Launch

We faced some issues at the systems level – there was no direct way to import the media that we have.

So now we’re gonna have to manually feed the media to the CDN and we might end up with HelpHub going up with no ability to upload media.

We’re gonna look at fixing the upload media portion with the Systems & Meta teams after.

This will likely take more time, I don’t have a clear estimate now. @clorith @netweb are working hard on it

There is also a content freeze in effect now to make sure we don’t need to do content migration twice when the migration is particularly difficult right now.

Phase 2 Starts

Current Focus

As a fair bit of the improvements require data from Phase 1 (e.g. how people use the site and getting appropriate feedback), we’ve decided to work on functionality that promotes the involvement from the wider audience.

Reminder for what we planned for Phase 2

Feedback Mechanism

A new issue was created to differentiate from the Article Voting functionality and a healthy discussion has started – https://github.com/Kenshino/HelpHub/issues/240

WP Versions

We voted to revisit requirements for this with the Core Team. The issue can certainly be written better – e.g. putting Codex screenshots to show what we’re replacing and how we intent for content to be restructured

A new Epic was created to track this – https://github.com/Kenshino/HelpHub/issues/249

GitHub issues

It was suggested that we have proper issues created (if not already) for each of the suggested parts of Phase 2. That is being worked on @pskli

Development Meta

Gulp/Grunt is currently broken on HelpHub repo. @pskli and @netweb are working to fix it.

AOB

Doc Team Meetings

We voted to alternate HelpHub meetings with Documentation Team meetings. This is especially helpful as HelpHub requires other Doc Team work such as Codex redirection for HelpHub to get the visitors it’s intended for.

Agenda for HelpHub meeting 2 July 2018

Hello all,

Next HelpHub meeting will happen on

Monday, July 2, 2018, 15:00 UTC

in #docs.

So it seems like the Meta team has to talk to the Systems team to Phase 1 deployed onto WordPress.org from the last update I got from @dd32

So let’s talk a little about Phase 2 today!

  1. Attendance
  2. Phase 1 Updates (if any)
  3. Phase 2 prioritisation (read this)
  4. 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/

Agenda for HelpHub meeting 18 June 2018

Hello all,

Next HelpHub meeting will happen on

Monday, June 18, 2018, 15:00 UTC

in #docs.

So we’ve definitely exceeded our deadline but the meta team is still helping to push things along. Most people are going to be on their journey back home from WCEU, so let’s just make this meeting a short one to catch-up!

  1. Attendance
  2. Post WCEU discussions
  3. 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

Agenda for HelpHub meeting 4 June 2018

Hello all,

Next HelpHub meeting will happen on

Monday, June 4, 2018, 15:00 UTC

in #docs.

We have extended a week to our self imposed deadline which puts getting HelpHub live on WordPress.org on a new date of 7 June 2018

  1. Attendance
  2. State of MVP
    • Content
    • Design
    • Development
  3. Bug Scrub
  4. 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
  • Previous meeting minutes – https://make.wordpress.org/docs/2018/06/04/summary-of-helphub-meeting-28-may-2018/

Summary of HelpHub meeting 28 May 2018

Attendance

@kenshino @mapk @atachibana @milana_cap @clorith @felipeelia @grimlord1 @kafleg attended

Content Updates

@tomf brushed up WordPress History
https://wp-helphub.com/getting-started/history/

@atachibna wrote user documentation relating to Personal Data tools in Version 4.9.6. After some users review, will be convert to helphub.
https://codex.wordpress.org/Tools_Erase_Personal_Data_Screen
https://codex.wordpress.org/Tools_Export_Personal_Data_Screen
https://codex.wordpress.org/Settings_Privacy_Screen

Also working with language section (#201) so that it is displayed in the sidebar section as like as Wikipedia’s language link.

Design Updates

@mapk will prepare mockup of Archive pages with Grid style (not list).
@mapk also suggested to show H2 elements only in the TOC. @zzap will put in a filter to allow H3 elements display (default is hidden).

Development Updates & Bug Scrub

We have also decided to punt primary categories and keep articles without a category base for permalinks for Phase 1. A deeper look into how articles are discovered is necessary before we decide on the role of permalinks in such.

@clorith is already discussing with meta team about the release of helphub.
We need an extra week with the remaining items being up and the need to get meta on board.

4 items are left on this milestone “version 1”:
#201 Language sections: @atachibana
#206 Archives: @mapk, @clo
#214 TOC: @milana_cap
#111 Sidebar Navigation: @felipeelia

 

Agenda for HelpHub Meeting 28 May 2018

Hello all,

Next HelpHub meeting will happen on

Monday, May 28, 2018, 15:00 UTC

in #docs.

We have about 3 days to our self-imposed deadline of May 31 for releasing HelpHub onto WordPress.org. We’re likely going to look at extending for a week at least to get the last few items in.

  1. Attendance
  2. State of MVP
    • Content
    • Design
    • Development
  3. Bug Scrub
  4. 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
  • Previous meeting minutes – https://make.wordpress.org/docs/2018/05/27/summary-of-helphub-meeting-21-may-2018/

Summary of HelpHub meeting 21 May 2018

Attendance

@kenshino @milana_cap @carl-alberto @tomf @chetan200891 @felipeelia @clorith attended

There were no Content & Design updates in the meeting; we’ll catch up with them the next!

Development Updates

We’re still missing the side bar and it’s related work to be done to finish up Phase 1. While the majority of Phase 1 is complete, without those items in, discovery of content would be next to impossible. 

We’re definitely looking to finish those items before launch. It turns out as well that the Meta team is busy with GDPR and launch would likely get delayed anyway!

@felipeelia volunteered to work on the side bar

@clorith will have a chat with @netweb about the likely merge of all code into Meta first week of June

@kenshino would really like to be able to announce HelpHub’s launch during WCEU

We have also decided to punt primary categories and keep articles without a category base for permalinks for Phase 1. A deeper look into how articles are discovered is necessary before we decide on the role of permalinks in such.

Bug Scrub

  • https://github.com/Kenshino/HelpHub/issues/201 – We’re hoping @atachibana can pick this up as he wrote the original code
  • https://github.com/Kenshino/HelpHub/issues/152 – This is an improvement to the local development tool, it’s not urgent and we’re hoping for @tomjn to put up a PR once he’s less busy with VVV 🙂
  • https://github.com/Kenshino/HelpHub/issues/50 – this might be useful if we have a lot of code snippets. But not important for Phase 1 so punted.
  • https://github.com/Kenshino/HelpHub/issues/9 – While it is likely the Support Forums will boot up an Elasticsearch instance to handle search. Getting the instance up is only a tiny part of the entire effort to make search an intuitive and useful experience. Getting the content indexed is easy but we’ll have to work on the UX and teach it to understand the content we’re building. This is likely a Phase 2 or a Phase 3 effort. 

You may catch up with the meeting details via the transcript

Agenda for HelpHub Meeting 21 May 2018

Hello all,

Next HelpHub meeting will happen on

Monday, May 21, 2018, 15:00 UTC

in #docs.

We have about 10 days to our self-imposed deadline of May 31 for releasing HelpHub onto WordPress.org

  1. Attendance
  2. State of MVP
    • Content
    • Design
    • Development
  3. Bug Scrub
  4. 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
  • Previous meeting minutes – https://make.wordpress.org/docs/2018/05/14/summary-for-helphub-meeting-14-may-2018/