Summary for Docs Team Meeting 12 August 2019

Attendance

@kenshino @milana_cap @atachibana @clorith @David Curtiss @bph @leogermani @juliobox @softservenet @audrasjb @chrisvanpatten @clorith

Development

We are waiting for @netweb to finish setting up SVN and GIT repos together. Meanwhile @milana_cap started working on https://github.com/WordPress/HelpHub/issues/214 Once the new workflow is completed regular bug scrubs will be scheduled again.

Mobile view of HelpHub is identified as making HelpHub hard to use so we are going to prioritize those fixes if we don’t get the git + svn work done by this week.

Content

There are no requests for new pieces that we need to write. @atachibana volunteered to follow the state of Block Editor user’s docs as it is still hard to be found by people. @bph volunteered to help. They will reach out to @karmatosed regarding improvements.

We would like to have some input from Support Team on obvious gaps for Block Editor Docs. @clorith will bring this up on their next meeting.

@leogermani did half of remaining redirects and updated the spreadheet, expecting to finish everything by the end of the week. @audrasjb volunteered to help, @juliobox is already on it.

Design

Skipped due to missing reps.

Rosetta Releases

Japaneese release gathered 11 volunteers. Serbian rosetta still doesn’t have HelpHub enabled. @kenshino will ping @sergey about this.

Open Floor

We currently have 288 user notes (DevHub comments) in queue. @audrasjb volunteered to help with reviews. @softservenet will start a spreadsheet of Docs Team’s ongoing tasks and members working on them. 

Next Docs meeting is in #docs channel on

Monday, August 19, 2019, 15:00 UTC

You can take a look at the meeting transcript via this link: https://wordpress.slack.com/archives/C02RP4WU5/p1565622003178300

#docs

Summary for HelpHub meeting 17 June 2019

Attendance

@nao @Pieter @chetan200891 @justinahinon @jeffmatson @makewebbetter @felipeelia

Phase 1.5 Development

@milana_cap Fixed

  • https://meta.trac.wordpress.org/ticket/4267

and waiting the merge

  • https://meta.trac.wordpress.org/ticket/4491

Still Open

  • https://meta.trac.wordpress.org/ticket/4492
  • https://meta.trac.wordpress.org/ticket/4493

If you want to tackle these issues, read below article at first to construct the development environment.
https://github.com/WordPress/HelpHub/blob/master/CONTRIBUTING.md

Phase 1.5 Design

@ibdz waiting for response on these:

  • https://github.com/WordPress/HelpHub/issues/245
  • https://github.com/WordPress/HelpHub/issues/246
  • https://github.com/WordPress/HelpHub/issues/201

Comment your thoughts to each issue. In WCEU, these items will be discussed with design team.

Contents Redirection

HelpHub migration and redirection were completed.
Next our goal is redirection of developer related pages such as Function, Class and Hooks.
Refer this article for step by step guide:
https://make.wordpress.org/docs/handbook/code-reference/editing-articles/

Stats: https://docs.google.com/spreadsheets/d/15hpEbbnuWJZ0DJafyCeG3CFRMtSxX1gY-RObrrjzzdw/edit#gid=1576070270

Docs team agenda plan in WCEU

  1. HelpHub in i18n (@nao)
    It should be collaboration of docs, polyglots and meta
  2. New Handbook plan for common programming topics (@atachibana)
    Refer this proposal:
    https://make.wordpress.org/docs/2019/05/19/proposal-wordpress-developer-handbook-for-common-topics/

Agenda for HelpHub meeting 17 June 2019

Hello all,

Next HelpHub meeting will happen on

Monday, June 17, 2019, 15:00 UTC
  1. Attendance
  2. Phase 1.5 Check-in
  3. Detailed content discussions
  4. Docs team agenda in WCEU
    • What items should we discuss?
  5. AOB

Helpful Links

Summary for HelpHub meeting 3 June 2019

Attendance

@kartiks16 @ibdz @kafleg @tjnowell @jnashhawkins @atachibana @nao @welcher @milana_cap

Content Migration And Redirection Status

@atachibana reported that until today, all Phase 2 contents and Version pages were migrated and redirected. 10 pages remain from Phase 1 contents to be redirected.

Phase 1.5 – Design

@ibdz proposed the design for Versions page and will update the responsive table design for mobile next week:
https://github.com/WordPress/HelpHub/issues/246

Phase 1.5 – Development

Github issues (and their PRs) closed:

  • https://github.com/WordPress/HelpHub/issues/232
  • https://github.com/WordPress/HelpHub/issues/230
  • https://github.com/WordPress/HelpHub/issues/229

and moved to Trac:

  • https://meta.trac.wordpress.org/ticket/4491
  • https://meta.trac.wordpress.org/ticket/4492
  • https://meta.trac.wordpress.org/ticket/4493

It would be great if we could have good-first-issue keyword in Trac.

We are still waiting for this one to get any response:
https://meta.trac.wordpress.org/ticket/4267

It’s uncertain if there will be another bug scrub before WordCcmp Europe. Last bug scrub notes ca be found here:
https://make.wordpress.org/docs/2019/04/28/helphub-bug-scrub-notes-26-april-2019/

AOB

Let’s create the list of of things to do at WCEU Contributor Day in next couple of weeks.

Meeting transcript: https://wordpress.slack.com/archives/C02RP4WU5/p1559574009010300

Agenda for HelpHub meeting 3 June 2019

Hello all,

Next HelpHub meeting will happen on

Monday, June 3, 2019, 15:00 UTC
  1. Attendance
  2. Phase 1.5 Check-in
  3. Detailed content discussions
  4. AOB

Helpful Links

Summary for HelpHub meeting 20 May 2019

Attendance

@atachibana @milana_cap @kenshino @mkaz @joyously @FahimMurshed @ibdz @juhise @truongwp @Marcio Zebedeu @bharatkambariya @justinahinon @aurooba attended

Phase 1.5 – Development

No updates. In last weekend, @milana_cap had been organizing local WordCamp.

Design

@ibdz is now officially leading design for HelpHub, and he is already done some work with the WordPress Versions table page.
He has some design pattern of responsive table that needs to be discussed in design meeting this week, and will leave comments for these design label issues:

https://github.com/WordPress/HelpHub/issues?q=is%3Aopen+is%3Aissue+label%3Adesign

Content Migration

@milana_cap lead Contributor Day’s docs team and redirected 96 pages or 87% of queued tasks. Thank you all: @Zoran Koneski @colovicc @zdravkosokcevic100 @bloop434 @lazarus9 @zockey @MilosJS

@aurooba will have a Contributor Day on this Saturday in Calgary.
2 Version pages were missing in Codex.

@atachibana fixed 3.9.5 and will fix 1.5.1.1

AOB

There are 2 proposals on P2. Please feel free to comment.

What’s the best way to use the More Info section?
https://make.wordpress.org/docs/2019/05/13/the-best-way-to-use-the-more-info-section/

Proposal: WordPress Developer Handbook for common topics
https://make.wordpress.org/docs/2019/05/19/proposal-wordpress-developer-handbook-for-common-topics/

HelpHub Bug Scrub Notes, 26 April 2019

HelpHub bug scrub is back. For the time being we’re planning to hold these once a month. If there’s a need, we’ll reconsider this decision. All the meetings will be happening in #meta-helphub channel.

At this point, HelpHub has two places for issues: Trac and Github. Our aim is to move all Phase 1.5 issues from Github to Trac as these issues are really just fixes for what is already live at wordpress.org/support. Phase 2 is planned to be worked on at Github for now.

Responsibility for Trac issues is very unclear and should be discussed between docs and meta teams. We don’t want to step on each other’s toes so it would be beneficial for both teams to make it clear who’s responsible for responses and decisions regarding reported issues.

At this bug scrub meeting we were discussing only Phase 1.5 issues.

Content

Content has only one issue on Github. @atachibana said he’ll comment on it and close it.

Another content related issue is opened on track https://meta.trac.wordpress.org/ticket/4195. It is highly recommended that content reps of documentation team get involved in discussion.

Design

We need decisions for 3 design related issues on Github. Also, we should see if @iviolini is still available for the project.

Development

Good first issues

During bug scrub we detected several issues that can be labeled as “good first issue”. They require either simple fix or just copying code from Github PR.

  1. https://meta.trac.wordpress.org/ticket/4267 – need switching h2 for h1 as explained here
  2. https://github.com/WordPress/HelpHub/issues/239 – has code in PR
  3. https://github.com/WordPress/HelpHub/issues/232 – has code in PR
  4. https://github.com/WordPress/HelpHub/issues/230 – has code in PR
  5. https://github.com/WordPress/HelpHub/issues/229 – has code in PR

Need discussion

1. https://github.com/WordPress/HelpHub/issues/237

We have to decide which is appropriate for HelpHub

  • To keep the order of TOC as like as (paper) book, or
  • To show the latest article as like as Search results

2. https://github.com/WordPress/HelpHub/issues/231

We need to properly redirect this URL https://wordpress.org/support/category/. It’s not directly accessible from anywhere but it is possible to arrive from, let’s say, here https://wordpress.org/support/category/advanced-topics/ by editing URL.

Ready for coding

Attendance

@atachibana @sergeybiryukov @felipeelia @milana_cap

You can read a transcript of the meeting at https://wordpress.slack.com/archives/CG47GT4G2/p1556290821016800

The next bug scrub will happen in late May. Date and time will be discussed and published prior.

#bug-scrub

HelpHub Bug Scrub

HelpHub bug scrub is back. We’ll test Friday 3PM UTC as possible time for regular monthly bug scrub.

We’ll go through Github issues for Phase 1.5.

Content issues: https://github.com/WordPress/HelpHub/issues?q=is%3Aissue+is%3Aopen+label%3A%22Phase+1.5+-+Content%22

Design issues: https://github.com/WordPress/HelpHub/issues?q=is%3Aissue+is%3Aopen+label%3A%22Phase+1.5+-+Design%22

Development issues: https://github.com/WordPress/HelpHub/issues?q=is%3Aissue+is%3Aopen+label%3A%22Phase+1.5+-+Development%22

Pinging @atachibana for content and @iviolini for design issues. Everyone are welcome to attend and participate.

Bug scrub will happen in #meta-helphub channel on

Friday, April 26, 2019, 15:00 UTC

#bug-scrub

Summary for HelpHub Meeting 22 April 2019

Attendance

@makewebbetter @milana_cap @softservenet @atachibana

Phase 1.5 Content Migration

@atachibana will take a look at content related Github issue and confirm its validity. https://github.com/WordPress/HelpHub/issues/247

Phase 1.5 Design

There are 3 design related Phase 1.5 issues on Github: https://github.com/WordPress/HelpHub/issues?q=is%3Aissue+is%3Aopen+label%3A%22Phase+1.5+-+Design%22

We need some decisions made by @iviolini here.

Phase 1.5 Development

We have 8 development related issues: https://github.com/WordPress/HelpHub/issues?q=is%3Aissue+is%3Aopen+label%3A%22Phase+1.5+-+Development%22t%22

Some have ready PRs with conflicts and some need decisions to be made. But first of all, we need to clean up the code to comply with WPCS. Hopefully this will be finished by the end of the week so we can start merging PRs again. Once the WPCS issues are done we can resolve conflicts on PRs and hand them over to meta team.

All issues with PR’s are valid for on wordpress.org/support

Gutenberg Docs

No updates from @daveryan.

HelpHub localisation

Discussion is going on here https://make.wordpress.org/polyglots/2019/02/25/helphub-localisation-plan/

Notes from first meeting https://make.wordpress.org/polyglots/2019/03/27/helphub-localisation-plan-meeting-notes/

Everyone are welcome to get involved.

Bug scrub

We’ll have one bug scrub this week just to cleanup the Phase 1.5 issues from Github: https://github.com/WordPress/HelpHub/issues?q=is%3Aissue+is%3Aopen+label%3A%22Phase+1.5%22

On Friday, 26th April, the same time as regular meetings – 3PM UTC.

Friday, April 26, 2019, 15:00 UTC

After that we’ll set regular bug scrubs once a month, as a start. Everyone are welcome to attend.

AOB

@softservenet volunteered to keep an eye on new WordPress versions and update History page: https://wordpress.org/support/article/history/

This can be considered as one of the “Content” tasks for the Contributor Badge criteria.

You can read a transcript of the meeting at https://wordpress.slack.com/archives/C02RP4WU5/p1555945213124800

Agenda for HelpHub meeting 22 April 2019

Hello all,

Next HelpHub meeting will happen on

Monday, April 22, 2019, 15:00 UTC
  1. Attendance
  2. Phase 1.5 Check-in
  3. Detailed content discussions
    • Content Migration Check-in (@atachibana)
    • Gutenberg Docs (@daveryan)
  4. HelpHub localisation
  5. Setup regular development bug scrub
  6. AOB

Helpful Links

  • HelpHub Staging – https://wp-helphub.com/
  • GitHub repo – https://github.com/WordPress/HelpHub
  • State of HelpHub (read for Phase 2) – https://make.wordpress.org/docs/2018/02/26/state-of-helphub-february-2018/
  • Previous Docs Team minutes – https://make.wordpress.org/docs/2019/04/08/summary-for-docs-team-meeting-1-april-2019/