Summary for Helphub Meeting February 20

Content

MVP for content is marked as: better content, internal search, improved readability (design and content wise) and better article discovery (through better categorisation). We also need more content migrated from codex and we need more help with it. If you are interested please reach out for @atachibana on slack and he’ll provide the “how and where”.

Development Updates

We have two options for improving local development of HelpHub with VVV:

  • Rearrange the Helphub repo to fit into a VVV custom site template, it means mostly moving stuff to a public_html subfolder, and adding a provisioner and logs folder.
  • Wait for some VVV changes that might arrive in a month or two’s time that make specifying a wp-content folder easier, then update the documentation.

Voting is happening in slack.

MVP (Phase 1)

  1. Get the PR approved and merged – #154.
  2. Finalize the article CPT – rewrite rule (prefixed slug and the first CPT should have /article/ as the domain path).
  3. Set up the front page (which re-positions the current front page).

Attendance

@kenshino @clorith @atachibana @milana_cap @kafleg @wizzard @tomjn @xkon

Read the meeting transcript in the Slack archives. (A Slack account is required)

#summary

Summary for Helphub Meeting Februar 13

Content

Content status page is updated, you can find it here. Twenty Seventeen article is migrated. Also, there is a new article in review process about password best practices, as explained in track ticket.

Development Updates

Somehow along the way, we lost path to the original plan, which is that HelpHub is a static content part of Support forums. The goal is to drive people to solve their own problems before getting to the forums.

Here are wireframes.

Therefore, home page for HelpHub is actually current home page for support. Articles are going to live under /support so we need to create CPT templates for HelpHub related content. It is agreed for CPT to be under “articles” slug. We need a script for migrating all existing articles on HelpHub to CPT, GitHub issue #153.

Articles should be simpler with a limited, right-side sidebar that showed a few basic things like related articles and such, with meta information at the bottom of the page. In rtl languages, the sidebar would be on the left. We might need custom post template for Guides as they need ToC (this will be marked as Phase 2), which is not always the case with Articles. For Articles, if needed, we might try a different approach with horizontal ToC.

Forums would also show at the bottom of search results, as a last resort if search didn’t help in finding the answer. Or at the bottom of an article, if article didn’t cover the problem.

Next steps

  • Replace current theme in Github repo with the Support one, @clorith volunteered.
  • Start tagging Github issues with MVP.
  • Properly define an MVP on next meeting.
  • Define a launch date, which will help give the push to everyone working on project to tide it over. End of May is proposed but this really depends on MVP and available people.

AOB

There was also a discussion about how docs team is going to use Gutenberg (the new editor) for the purpose of writing articles/guides and how to include it in our Handbook.

Attendance

@kenshino @clorith @atachibana @samuelsidler @xkon @chetan200891 @milana_cap

Read the meeting transcript in the Slack archives. (A Slack account is required)

#summary

Summary for Helphub Meeting Februar 06

It’s been a while since the last meeting and, therefore, this meeting was more about getting back on track than updates. In general, we need to create a plan with exact goals regarding content, design and functionality defined. With this plan tasks and necessary steps will be more clear.

Content

We don’t have updates on migration state. However, we should consider what content (that is not present in codex) could be useful for today’s end users. One such example is #40237Educate users about modern password best-practices.

I’d love to hear some thoughts on this (cc @atachibana).

Design Updates

Home page design is blocked by several questions. These questions should be answered as soon as possible in order to move forward with design and development for home page.

Development Updates

Sidebar navigation is in progress at the moment. We’ll follow design from other .org Handbooks but, for the time being, populating sidebar will be done manually.

AOB

@tjnowell did awesome work in fixing documentation for setting up VVV. He did the same for core Handbook as well, and opened issue on GitHub for fixing the process in our CONTRIBUTING document. He’s a hero!

Attendance

@tjnowell @mapk @clorith @kenshino @milana_cap

Read the meeting transcript in the Slack archives. (A Slack account is required)

#summary

Summary for Helphub Meeting October 24

Migration Updates

CSS Shorthand in Codex is updated as well as initial draft of HelpHub (Homepage) Contents page. This page shows how many pages are missing. This creates new list of Migration candidates which will be known under working title “Phase 3”.

Design Updates

Now that we have initial draft for Homepage it would be great if someone would do design for it.

Development Updates

Staging has been updated with latest code from master. Work on sidebar styling has been started. Also, there’s been discussion on Versions archive page.

AOB

First draft on documentation about VVV instance for contributing to HelpHub with code on Contributor Day is done and next phase would be including HelpHub repo in it.

Attendance

@atachibana @davidmlentz @milana_cap

Read the meeting transcript in the Slack archives. (A Slack account is required)

#summary

Summary for Helphub Meeting October 17

Migration Updates

Recent updates:

  • Managing Plugins
  • Dashboard Screen, and Customizing Your Sidebar
  • Before You Install, Image Size and Quality
  • Updated How to install WordPress

Gutenberg documents – recently, updated by V1.0.4 screen and function.

Design Updates

Design for home page will be worked on once we have finished content for it.

Development Updates

Bug scrubs have little to no point at this moment and are on pause for the time being. Blog posts updates will be continued with though. Latest master will be deployed to staging.

AOB

Started discussion about setting up VVV instance for contributing to HelpHub with code on Contributor Day.

Attendance

@atachibana @picturecities @davidmlentz @mapk @kenshino @hardeepasrani @audrasjb @khoipro @milana_cap

Read the meeting transcript in the Slack archives. (A Slack account is required)

#summary

Summary for HelpHub Bug Scrub 05 October 2017

Slack transcript available here.

Closed issues

These issues are found unrelated for current development phase or fixed by other issues.

All closed issues

Closed pull requests

All closed PRs

Discussions

Active discussions about Home page template, Article voting functionality and Feature post sidebar frontend are happening on Github.

Next meeting will happen today, Thursday, October 12, 2017, 17:00 UTC in #docs channel. You all are invited.

#bug-scrub, #summary

Summary for HelpHub Bug Scrub 21 September 2017

There was no bug scrubs last week, this is summary for the week before. Slack transcript available here.

Closed issues

These issues are found unrelated for current development phase or fixed by other issues.

All closed issues

Closed pull requests

All closed PRs

Discussions

There’s been discussion about old issues. Hopefully, the idea around them is more clear now. Home page template and article voting functionality are being discussed about in Github.

Next meeting will happen today, Thursday, October 05, 2017, 17:00 UTC in #docs channel. You all are invited.

#bug-scrub, #summary

Summary for HelpHub Bug Scrub 14 September 2017

Slack transcript available here.

There were no closed issues since our last meeting.

All closed issues

All closed PRs

Discussions

We all agreed that reading time is not helpful and even misleading for HelpHub, so that should be removed before merging.

It has been reported that some issues are old and not providing clear tasks. It’s been quiet last few weeks so we might address these issues on next scrubs (today). It would be good to mark them and either clarify or close them. This meeting will happen today, Thursday, September 21, 2017, 17:00 UTC in #docs channel. You all are invited.

#bug-scrub, #summary

Summary for HelpHub Bug Scrub 7 September 2017

Slack transcript available here.

There were no closed issues since our last bug scrubs but two pull requests are closed – #140 and #147.

We got some attention which will, hopefully, bring more contributors to HelpHub. There are a couple of new people preparing their local installs (yeey).

All closed issues

All closed PRs

Home page template and powerful search are still hot topics.

Home Page Template

Home page template discussion is happening here. Please feel free to join, everyone’s opinion is welcomed.

Search Epic

Issues/PRs under Search epic: #8, #9, #47 and #37.

Huge thank you to all who contribute, you’re mega champions.

Next bug scrub will happen today, Thursday, September 14, 2017, 17:00 UTC in #docs channel and you all are invited. We can discuss any issue.

#bug-scrub, #summary

Summary for HelpHub Bug Scrub 31 August 2017

There were no closed issues or pull requests since our last bug scrubs. However, we had a good discussion about home page template and search functionality. These are going to be the main focus in following period. We are hoping to have intuitive search and helpful home page in order to prevent asking the same questions in forums.

Home Page Template

Home page template discussion is happening here. Please feel free to join, everyone’s opinion is welcomed.

Search Epic

Initial plans included Elastic Search for search functionality. This is something we want to apply with addition to possible usage of WP REST API for refining search results via filters. Again, feel free to join discussion, share experiences and ideas, or even code. Any help is welcomed.

Issues/PRs under Search epic: #8, #9, #47 and #37.

Slack transcript available here.

Huge thank you to all who contributed, you’re super heroes.

All closed issues

All closed PRs

Next bug scrub will happen today, Thursday, September 07, 2017, 17:00 UTC in #docs channel and you all are invited. We can discuss all the issues but keep in mind the focus on home page template and Search.

#bug-scrub, #summary