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 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: https://github.com/WordPress/HelpHub/issues/237

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 WordPress.orgWordPress.org 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. https://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 meeting 26 August 2019

Hello all,

We have missed a few HelpHub meetings because of schedule and SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. 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
    • Content MigrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. Check-in (@atachibana)
    • Redirection Status (@atachibana)
  4. Design
  5. HelpHub rosetta release
  6. AOB

Helpful Links

  • HelpHub Production – https://wordpress.org/support/
  • GitHubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/ 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/

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 SVNSVN Apache Subversion (often abbreviated SVN, after its command name svn) is a software versioning and revision control system. Software developers use Subversion to maintain current and historical versions of files such as source code, web pages, and documentation. Its goal is to be a mostly compatible successor to the widely used Concurrent Versions System (CVS). WordPress core and the wordpress.org released code are all centrally managed through SVN. https://subversion.apache.org/. and GITGit Git is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency. Git is easy to learn and has a tiny footprint with lightning fast performance. Most modern plugin and theme development is being done with this version control system. https://git-scm.com/. 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 BlockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. 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 pingPing The act of sending a very small amount of data to an end point. Ping is used in computer science to illicit a response from a target server to test it’s connection. Ping is also a term used by Slack users to @ someone or send them a direct message (DM). Users might say something along the lines of “Ping me when the meeting starts.” @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 migrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. and redirection were completed.
Next our goal is redirection of developer related pages such as Function, Class and 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..
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 metaMeta Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress.
  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
    • Content MigrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. Check-in (@atachibana)
    • Redirection Status (@atachibana)
  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 MigrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. 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

GithubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/ 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 TracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub.https://core.trac.wordpress.org/.:

  • 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 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 https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-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
    • Content MigrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. Check-in (@atachibana)
    • Redirection Status (@atachibana)
  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 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..

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

@milana_cap lead 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 https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-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 P2P2 P2 or O2 is the term people use to refer to the Make WordPress blog. It can be found at https://make.wordpress.org/.. 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 GithubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/ to TracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub.https://core.trac.wordpress.org/. 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 metaMeta Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. 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 URLURL A specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org 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

  • https://github.com/WordPress/HelpHub/pull/261 – has PR but the code is violating WPCSWPCS The collection of PHP_CodeSniffer rules (sniffs) used to format and validate PHP code developed for WordPress according to the WordPress Coding Standards. May also be an acronym referring to the Accessibility, PHP, JavaScript, CSS, HTML, etc. coding standards as published in the WordPress Coding Standards Handbook.
  • https://github.com/WordPress/HelpHub/issues/214 – it’s been suggested that we should omit children from TOC but at the meeting we agreed that we want children – ignore the code in PR
  • https://github.com/WordPress/HelpHub/issues/111 – we don’t use Handbook pluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party so we can’t replicate the toggles. We should, however, try to style everything else.

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 GithubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/ 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