leogermani 4:57 pm on September 23, 2019
Tags: ,   

Summary for HelpHub Meeting 23 September 2019

Attendance

@FahimMurshed @atachibana @tomf @zzap @ibdz @estelaris @Kenshino (Jon) @leogermani

Content

@atachibana informs: Now we are redirecting Codex to Code Reference (DevHub). 210/858 24.5% (last week 23.3%) was done.

Link to the spreadsheet where migration is being monitored: https://docs.google.com/spreadsheets/d/15hpEbbnuWJZ0DJafyCeG3CFRMtSxX1gY-RObrrjzzdw/edit#gid=1576070270

Anyone can join these tasks by following below steps:
https://make.wordpress.org/docs/handbook/code-reference/editing-articles/

@leogermani says Last week we had less than 1% of hooks redirected and now we have 2% \o/

Design review

@estelaris has been working on a new design to the support home page. There was a review with the design team and they would like to get rid of the grid and use a list instead.

The screenshot of the work in progress was shared in the related ticket: https://meta.trac.wordpress.org/ticket/4493#comment:8

Related tickets https://meta.trac.wordpress.org/ticket/4492 and https://meta.trac.wordpress.org/ticket/4491 were also updated and any feedback on the design can be given there.

Development

@milana_cap updates:

  • We are still waiting for @netweb’s setup if I haven’t miss anything last week.
  • during Contributor Day I did review and updated the Dashboard Widgets page in Common APIs Handbook
  • we had @Jaap Wiering working on concept for adding Accessibility notes and instructions where ever possible in DevHub and HelpHub

@milana_cap adds that with all the design changes being worked, it should be better to wait. @estelaris says that today #design and #accessibility teams should be free and I will get approval for both designs. “Will do my best to have them ready for development next week”

HelpHub rosetta release

@atachibana says “Japanese HelpHub migration does not have good progress ;-( 7 of 166 (4.2%) was done. We’ll encourage volunteers.”

@milana_cap says “Serbian team has momentum but then we’ve got it enabled on wrong website and waited for fix. It’s fixed now so I’ll make sure we start working on it this week. I’m trying to encourage others to lead the project”

Open Floor

@leogermani asked if there were any previous discussion on adding a “send feedback” or “inform error” button on the articles on HelpHub, to make it easier for people to contribute. Some people currently open trac tickets or send messages in the slack channel directly.

Apparently there is not and he might open a trac ticket to discuss that.

Transcript

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

Jon (Kenshino) 9:36 am on September 23, 2019  

Agenda for HelpHub meeting 23 September 2019

Hello all,

The next HelpHub meeting will happen on

Monday, September 23, 2019, 15:00 UTC
  1. Attendance
  2. Content status @atachibana
  3. Design review – @estelaris
  4. Development (@milana_cap / @netweb)
  5. HelpHub rosetta release
  6. AOB

Helpful Links

Jon (Kenshino) 9:34 am on September 16, 2019  

Agenda for Docs Team meeting 16 September 2019

Our next Documentation Team meeting is scheduled on

Monday, September 16, 2019, 15:00 UTC

in the #docs channel on Slack

Current Projects Updates:

  1. Content Migration from Codex to HelpHub & DevHub – @atachibana
  2. HelpHub development – @milana_cap and @clorith
  3. Inline Docs – @drewapicture and @atimmer
  4. Docs Team Handbook – @milana_cap
  5. HelpHub localisation
  6. Common APIs Handbook – @atachibana

Open Floor

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

Akira Tachibana 2:17 am on September 16, 2019
Tags: needs-desing   

Summary for HelpHub Meeting 9 September 2019

@kenshino @milana_cap @leogermani @kafleg @aion @softservenet @Pieter @audrasjb @estelaris @bph @joyously

Development

Development of HelpHub was blocked for 2 things and discussed:

@estelaris commented for HelpHub design:
https://docs.google.com/spreadsheets/d/1ZnhtiLxqjXviFlnWsDE5L8YRiBXtkmanvM8doIc1lrg/edit#gid=0
This is the document to gather all the requirements docs team has.

Design team review

They reviewed two things:

  1. mobile view
    https://github.com/WordPress/HelpHub/issues/235
    They agreed that it needs to change, so they are working on a template to be used by the entire WP.org ecosystem.
  2. anchor symbol
    They are thinking about using a similar treatment to GitHub. It will be global as well.

#needs-desing keywords for tickets

@estelaris added needs-design keyword to 3 trac tickets:

@estelaris will look into those 3 this week and will add screenshots

Improbements for archives

Docs Team did make some decisions on previous meeting that should improve usability of them

  1. Team agreed to use custom excerpts for each article – this is extra work for content but we can all help perhaps we can add another column to @atachibana ‘s document.
  2. Order of posts will be set manually because we want to make it contextual/complexity/step-by-step order
    This can’t really be automated and applicable to every category so we’ll use the order functionality in Post Attributes and @felipeelia already created patch for it.

Dev flow setup

@kenshino will catch up with @netweb.
@leogermani will test the documentation to get the dev environment up.

HelpHub rosetta release

Now, there are two releases: Serbian and Japanese.
Serbian team had HelpHub enabled on wrong site. It was disabled then and enabled on /support/ so they are ready to go.
Japanese team shared guide for getting started with this.

French, Brazil, Russia and some other countries are in the line for that activation.

HelpHub contents migration

@leogermani migrated content and hooks. Top 3 actions and filters (total of 6) were done and @millana_cap reviewed.

Open floor

@milana_cap suggested to have different people leading the meetings, Like rotating but more volunteering. We can call it a facilitator rather than “leading”. The agenda already mentions people sho will “lead” each topic.

@leogermani volunteered to lead the next HelpHub meeting, and @softservenet follows.

Milana Cap 11:32 am on September 9, 2019  

Agenda for HelpHub meeting 9 September 2019

Hello all,

The next HelpHub meeting will happen on

Monday, September 9, 2019, 15:00 UTC
  1. Attendance
  2. Content status @atachibana
  3. Design review – @estelaris
  4. Development (@milana_cap / @netweb)
  5. HelpHub rosetta release
  6. AOB

Helpful Links

Jon (Kenshino) 3:23 am on September 2, 2019  

Agenda for Docs Team Meeting 2 September 2019

Our next Documentation Team meeting is scheduled on

Monday, September 2, 2019, 15:00 UTC

in the #docs channel on Slack

Current Projects Updates:

  1. Content Migration from Codex to HelpHub & DevHub – @atachibana
  2. HelpHub development – @milana_cap
  3. Inline Docs – @drewapicture and @atimmer
  4. Docs Team Handbook – @milana_cap
  5. HelpHub localisation
  6. Common APIs Handbook – @atachibana

Open Floor

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

Josepha 3:57 pm on August 30, 2019
Tags: ,   

X-post: Component Maintainers in 5.3

X-comment from +make.wordpress.org/core: Comment on Component Maintainers in 5.3

Milana Cap 8:33 pm on August 26, 2019
Tags: , ,   

Summary for HelpHub Meeting 26 August 2019

Attendance

@estelaris @kafleg @FahimMurshed @wizzard_ @softservenet @ibdz @felipeloureirosantos @justin @bph @kenshino @felipeelia @milana_cap @samikeijonen

Development

We discussed several issues today.

Excerpts on Archives

Last year it was proposed to replace auto generated excerpts with ToC list items. On today’s meeting discussion it’s been decided to use manually created excerpts which would contain the point of the article in one sentence. Short and concise. more meaning, less space.

Join discussion here: https://github.com/WordPress/HelpHub/issues/239

Posts Order on Archives

This was unsolved for a long time. We decided it’s important to order posts according to its content complexity so it resembles “Step 1, Step 2..” format or, if this doesn’t apply, to order according to post’s “importance”. As this is difficult to apply automatically to all categories we decided to use Post Attributes order and intentionally create order which we will specify in WP_Query.

As some articles have more than one category assigned, in which it might have different “importance” and order, we decided to make larger steps between posts using the same logic as menu items in dashboard. So two posts in a succession would have 10 places in between, rather than 1. This should also help with ordering articles published in the future.

Join discussion here: https://github.com/WordPress/HelpHub/issues/237

Single article mobile view

Viewing single article on smaller devices reveals the sidebar throughout the whole visible area. The rest of Handbooks solve this by hiding the sidebar altogether. @milana_cap suggested to place search form and single posts navigation instead of sidebar. For this single posts navigation to be useful, the order of posts (above) should be logical and intuitive.

@estelaris said that she’s working on templates and will discuss this issue on #design team meeting this Wednesday, as this is effecting all WordPress.org Handbooks.

Join discussion here: https://github.com/WordPress/HelpHub/issues/236

Design

@estelaris is working on overview of HelpHub design. Her analysis can be found in Google Spreadsheet: https://docs.google.com/spreadsheets/d/1ZnhtiLxqjXviFlnWsDE5L8YRiBXtkmanvM8doIc1lrg/edit?usp=sharing

After we agree on design template we need to have #accessibility review and usability test. @samikeijonen kindly accepted to perform these testings once we have everything ready.

Content and Rosetta Releases

We skipped these due to absence of key people.

Next Docs meeting is in #docs channel on

Monday, September 02, 2019, 15:00 UTC

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

Milana Cap 12:16 pm on August 26, 2019  

Agenda for HelpHub meeting 26 August 2019

Hello all,

We have missed a few HelpHub meetings because of schedule and Slack downtime – the next HelpHub meeting will happen on

Monday, August 26, 2019, 15:00 UTC
  1. Attendance
  2. Development (@milana_cap / @clorith)
  3. Detailed content discussions
  4. Design
  5. HelpHub rosetta release
  6. AOB

Helpful Links

  • HelpHub Production – https://wordpress.org/support/
  • 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 HelpHub meeting – https://make.wordpress.org/docs/2019/06/18/summary-for-helphub-meeting-17-june-2019/
Akira Tachibana 11:14 am on August 19, 2019  

Agenda for Docs Team meeting 19 August 2019

Our next Documentation Team meeting is scheduled on

Monday, August 19, 2019, 15:00 UTC

in the #docs channel on Slack

Current Projects Updates:

  1. Content Migration from Codex to HelpHub & DevHub – @atachibana
  2. HelpHub development – @milana_cap
  3. Inline Docs – @drewapicture and @atimmer
  4. Docs Team Handbook – @milana_cap
  5. HelpHub localisation
  6. Common APIs Handbook – @atachibana

Open Floor

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