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

Agenda for Helphub Design Meeting 24 Jan

Hello!

Time/date: Tuesday, January 24, 2017, 15:00 UTC in #docs

  1. Attendance
  2. Progress on Tasks
  3. AOB

You can find the main Helphub meeting’s agenda here.

Pinging @krogsgard @versatility @mapk @wizzard_

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

#agenda, #design

Agenda for Helphub Design Meeting 10 January 2017

Hello!

Time/date: Tuesday, January 10, 2017, 13:00 UTC in #docs

  1. Attendance
  2. Progress on Tasks
  3. AOB

You can find the main Helphub meeting’s agenda here.

Pinging @krogsgard @versatility @mapk @wizzard_

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

#agenda, #design

Summary for Helphub Design Meeting January 2

Attendance

@krogsgard @versatility @wizzard_ @kenshino attended

As previous efforts towards user research were largely undocumented, we’re making a renewed approach to understanding user needs and behaviour.

We will be doing the following

  1. @versatility will be documenting the various components of Helphub
  2. @versatility will build various prototypes of those components and use them for feedback/research
  3. We will work the ‘single’ views (e.g. how we perceive users would want to view the articles) before we build the journey on the Homepage that will lead them to those articles.
  4. 2 surveys will be created
    • One for the Support Team – likely an open ended question to gain sentiment on how they think users would approach help documentation
    • One for the end users – @wizzard_ will work on the questions with @versatility
  5. All efforts will be tracked and documented on Trello

A few considerations (possibly)

  1. Search should be a global and obvious element
  2. No sidebars as it lacks consistency with mobile

Search Use Cases

  1. Searching for a specific problem
  2. Searching for a general guide (e.g. total guide from installing to securing WordPress)
  3. They’re on Helphub but don’t know what search terms to use (so they’re just clicking on what looks right)

Some reference

  1. A discussion from the Support Team about personas and common topics

Next Meeting

Tuesday, January 10, 2017, 13:00 UTC – One hour before Helphub Meeting

#design, #summary

+make.wordpress.org/design