Summary for HelpHub Meeting 23 September 2019


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


@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 migrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. is being monitored:

Anyone can join these tasks by following below steps:

@leogermani says Last week we had less than 1% of hooksHooks In WordPress theme and development, hooks are functions that can be applied to an action or a Filter in WordPress. Actions are functions performed when a certain event occurs in WordPress. Filters allow you to modify certain functions. Arguments used to hook both filters and actions look the same. 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:

Related tickets and were also updated and any feedback on the design can be given there.


@milana_cap updates:

  • We are still waiting for @netweb’s setup if I haven’t miss anything last week.
  • during Contributor DayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of There are many teams that people can participate in, each with a different focus. I did review and updated the Dashboard Widgets page in Common APIs Handbook
  • we had @Jaap Wiering working on concept for adding AccessibilityAccessibility Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). ( 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 tracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub. tickets or send messages in the slackSlack Slack is a Collaborative Group Chat Platform The WordPress community has its own Slack Channel at channel directly.

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


You can take a look at the meeting transcript via this link:

Summary for HelpHub Meeting 26 August 2019


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


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:

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 categoryCategory The 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging. 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:

Single article mobile view

Viewing single article on smaller devices reveals the sidebarSidebar A sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme. 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 The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. Handbooks.

Join discussion here:


@estelaris is working on overview of HelpHub design. Her analysis can be found in Google Spreadsheet:

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:

Hello Docs folks There’s a new project set…

Hello Docs folks. There’s a new project/set of docs that I think it makes sense for this group to be responsible for, but I want to get your input and see if there are any team members with a bit of a track record of responsibility who’d like to step up and take charge of it/them (someone who’s not already responsible for another big project).

As you probably know, the content on (mostly WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. videos, though starting to include other WP presentations and tutorials, all of which you are free to embed in docs) has not been captioned/transcribed. Adding captions/transcripts will make this content accessible to deaf and hard of hearing community members, will make it easier for someone to scan a video’s content, and will allow search engines to get a better index. As we introduce the ability to add caption files, these docs will need to be reviewed and managed.

Volunteers on this project should have good spelling/grammar skills so they can correct errors that captioning volunteers make, and should be willing to watch the videos on to make sure the captioning volunteers did an accurate job.

The way it will work for now is that volunteers who want to contribute captions will do so on a third-party site (we’re recommending, but anything that lets you download a ttml file is fine). They’ll download the caption file (only the ttml format will work on, then upload it to through a form that will be available only to the vetted volunteers (at least for now).

Whoever steps up here will be a hero in the accessibilityAccessibility Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). ( effort, and will be responsible for wrangling captioning volunteers and ramping up new ones (eventually we should have some better docs and systems in place to require less hand-holding).

If anyone is interested in taking point on this, let’s hear it in the comments, and I can follow up with anyone who’s interested. We’re ready to launch this on Monday.

Note that members of the Accessibility group would participate in this effort under the aegis of the docs team, since docs is a product team, but accessibility is not. That said, someone from accessibility group who hasn’t participated in docs before also would be totally appropriate as the head volunteer.

#accessibility, #captions