Call for volunteers to help with 6.4 end-user documentation

The Docs team needs your help to update and revise the End User Documentation (HelpHub) for the upcoming WordPress 6.4 release, expected on November 7, 2023.

You can find a list of all the tasks in the 6.4 project board in the Documentation repository on 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/.

The tasks have been sorted into medium priority tasks and high priority tasks. The team plans to complete the high priority tasks by the 6.4 scheduled release date.

How you can help

If you are new to contributing to WordPress, you can review this onboarding post with training videos and links to help you get started.

  • Based on what you are interested in, review the medium priority tasks, or high priority tasks.
  • Add a comment on the GitHub issue you would like to work on, and someone on the Docs team will assign it to you.

Once a task is assigned to you, the following two videos show how to help with updating the existing articles in End User Documentation (HelpHub).

Video introduction: contributing to End User documentation
Video showing how to help with updating the existing articles on GitHub (this uses 6.2 as an example).

Once you complete the updates for the particular task, add a comment to the issue you were working on:

  • with a note on the changes you made
  • and tag the following contributors in the Docs team (on the Make WordPress 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/. docs channel add ‘@’ before the ID: femy, LeonardusNugraha, or jenni)
  • a contributor from the Docs team will be able to review the updates and add the content to the article

If you have questions or need help, ask in the docs channel on the Make WordPress Slack or directly in the GitHub issue itself.

If your meetupMeetup All local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area., collective or organization can give a 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. of time to help, leave a comment on this post or send a message to the documentation channel on the Make WordPress Slack and include the Release co-leads for 6.4 documentation in your message: (add ‘@’ before the ID) @abhanonstopnewsuk, @Femy, @611shabnam.

Resources

If you need a test site with WordPress 6.4 pre-installed, you can use this app provided by InstaWP to spin up a new temporary website. It is preloaded with Theme Test data and other pre-configuration and is ready to go. This new site will be available to use for four hours. After that, if you need another test site to contribute to docs, you can visit the link again and create a new temporary site.

When revising already published content on HelpHub, you can use the RevisionsRevisions The WordPress revisions system stores a record of each saved draft or published update. The revision system allows you to see what changes were made in each revision by dragging a slider (or using the Next/Previous buttons). The display indicates what has changed in each revision. Extended 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 that is already installed. Refer to the video: How we use the Revisions Extended plugin on Learn WordPress.

Where can I find other documentation on the 6.4 release?

The release group with other coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. and doc contributors have been working on developer notes related to major features and changes in 6.4. The Field Guide for WordPress 6.4 is available and brings together the most important items. You can also view all dev notes via the 6.4 developer notes tag.

Props to @webcommsat for input into this post and its review.

#6-4, #docs, #helphub

Call for volunteers to help with 6.3 end-user documentation

The Docs team needs your help to update and revise the End User Documentation (HelpHub) for the upcoming WordPress 6.3 release, expected on August 8th, 2023.

You can find a list of all the tasks in the 6.3 project board in the Documentation’s repo on 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/.

The tasks have been sorted into medium priority tasks and high priority tasks. The team plans to complete the high priority tasks by the 6.3 scheduled release date.

How you can help

If you are new to the Docs team, you can select from the list of good first issues.

If you are new to contributing to WordPress, you can review this onboarding post with training videos and links to help you get started.

Once a task is assigned to you, the following two videos show how to help with updating the existing articles in End User Documentation (HelpHub).

Video onboarding to End User documentation

Video showing how to help with updating the existing articles on GitHub (referencing 6.2 in this video)

Once you complete the updates for the task, add a comment to the issue you worked on, noting that you have made the changes, and tag the Docs team (@femkreations, @Leonardus-Nugraha or @jennimckinnon). Someone from the Docs team will review the updates and add the content to the article. 

If you have questions or need help, ask in the docs channel on the Make WordPress 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/. or directly in the GitHub issue itself.

If your meetupMeetup All local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area. or company can give a 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. of time to help, do include the Release co-leads for 6.3 documentation in your message: (Slack IDs) @Femy, @Leonardus Nugraha, @611shabnam.

Resources

If you need a test site with WordPress 6.3 pre-installed, you can use this app provided by InstaWP to spin up a new temporary website set. It is preloaded with Theme Test data and other pre-configuration, ready to go. This new site will be available to use for four hours. After that, if you need another test site to contribute to docs, you can visit the link again and create a new temporary site.


Props to @leonnugraha for reviewing this article.

#6-3, #docs, #helphub

Call for volunteers to help with 6.2 end user documentation

The Docs team needs your help to update and revise the End User Documentation (HelpHub) for the upcoming WordPress 6.2 release, expected on March 28, 2023.

You can find a list of all the tasks in the 6.2 project board in the Documentation’s repo on 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/.

The tasks have been sorted into medium priority tasks and high priority tasks. The team plans to complete the high priority tasks by the 6.2 scheduled release date.

How you can help

If you are new to the Docs team, you can select from the list of good first issues.

If you are new to contributing to WordPress, you can review this onboarding post with training videos and links to help you get started.

Based on what you are interested in, review the medium priority tasks, high priority tasks or good first issues.

Mention in a comment on the GitHub issue you would like to work on and someone on the Docs team will assign it to you.

Once a task is assigned to you, the following two videos show how to help with updating the existing articles in End User Documentation (HelpHub).

Video onboarding to End User documentation

Video showing how to help with updating the existing articles on GitHub

If you have questions or need help, ask in the docs channel on the Make WordPress 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/. or directly in the GitHub issue itself. If your meetupMeetup All local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area. or firm can give a 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. of time to help, do include the Release co-leads for 6.2 documentation in your message: (Slack IDs) @bph, @zzap, @Femy, and @abhanonstopnewsuk.

Resources

If you need a test site with WordPress 6.2 pre-installed, you can use this app provided by InstaWP to spin up a new temporary website set. It is preloaded with Theme Test data and other pre-configuration, ready to go. This new site will be available to use for four hours. After that, if you need another test site to contribute to docs, you can visit the link again and create a new temporary site.


Props to @bph @webcommsat @milana_cap for collaborating and reviewing this article.

#6-2, #docs, #helphub

Future plans for HelpHub

At the end of January, the 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 launched the new site for documentation, internally known as HelpHub. The team’s work is not done as we are still updating old articles and continue writing new ones. The goal is to release new feature articles as close to the latest WordPress version release as possible.

Still missing and tracking

  1. Update legacy colors #26
  2. The change log is still a work in progress #6
  3. Finish the documentation inventory https://github.com/orgs/WordPress/projects/23
  4. Review the handbook pages for HH and update all
  5. Review and close HH meta tickets
  6. Review and close tickets on HH developing repository

Next steps

Promote the work, tell the world! Announce it everywhere. It has been 8 years since the HelpHub project kicked-off. Most of the initial members are not around as contributors any longer.

The documentation team will continue working in bringing the updated documentation and promote collaboration with other teams, like:

  1. Discuss with polyglots teamPolyglots Team Polyglots Team is a group of multilingual translators who work on translating plugins, themes, documentation, and front-facing marketing copy. https://make.wordpress.org/polyglots/teams/. how can we help in implementing the new site map and reorganizing articles that are already translated. This effort will be different with each local team as it will depend on the local teams processes and availability.
  2. Update content with polyglots – can we create GH issue track per rosetta site? What would be the best process for each locale.
  3. Introducing the new documentation and developer sites in WordCamps, 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 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/. so we can encourage other teams to implement the changes in their own languages.
  4. Work with the training team to create a crosslink Resources 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. where we can link Learn videos/courses/tutorials and vice versa.

Props to @milana_cap for reviewing the content of this article.

#helphub

Development and design work continues on Helphub

Docs team, please refrain from updating/uploading articles on Helphub still. Work will continue until Friday 20 January.

I will update the team if we need more time.

For questions, 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.” @estelaris on docs 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/. channel.

#helphub

New design for HelpHub in WordPress.org

The end-user documentation or HelpHub will go through a transformation, both in the design and the site map. 

The refinements in the template will improve the user experience while searching for information. These improvements include one landing page for end-user and developers documentation that will be called Documentation. This is the entry port to both HelpHub and DevHub. Although this article focuses on HelpHub, there will be changes for DevHub in the future.

Showing the look of the new end-user documentation landing page showing the 4 categories and subcategories under each in two columns. There are links to developers documentation and the forums at the bottom of the page.

Better search

The new site map includes 4 main categories and subcategories under each. This will improve search and allow new articles to be added into the existing categories without creating a ‘miscellaneous’ categoryCategory The 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging..

New site map showing categories and subcategories

New features

Documentation will have a new headerHeader The header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes.. The team is dropping the word ‘Support’ and replacing it with ‘Documentation’. This area of the website will contain reference information rather than be a place where users interact with the Support team as described in the Renaming WordPress.org Support to Documentation.

The new header for end-user documentation replaces the word Support for Documentation

A changelog was added to keep historic information on each article. The user will have a better idea of how recent the information is.

Example of changelog

Other features that will help searching are the breadcrumbs, a new documentation submenu to the categories, a more prominent table of content and, a highlighted link to Support Forums.

Example showing placement for breadcrumbs table of contents and documentation search box, including the Support Forums block.

Another new feature was the retirement of the hash character at the end of the headlines as they were an 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). (https://en.wikipedia.org/wiki/Accessibility) issue and caused visual noise. The hash has been replaced by a link icon.

Appearance phases for the headlines

Documentation on mobile

The mobile version offers faster access to the specific topic in the article by using accordions to navigate long articles on mobile. The breadcrumbs, search and table of contents will remain at the top of the article.

Example of a documentation article on mobile.

The design

The design follows the style set by the News redesign. It is cleaner, jazzier and the new template opens the canvas to improve readability. Using also the same typography connects this design to the redesign of WordPress.

The color palette is simple and muted so as to not interfere with the multiple videos and screenshots used within the articles.

The work started at WCEU 2019 Contributors Day in Berlin. The following articles describe the work previously done.

Props to @milana_cap, @kenshino, and @atachibana for their direction on this project.

Props to @tobiasfeistmantl, @fmellitzer, @davidvie, @majaloncar, @pendraq, @igorel, @nobnob, @marcio-zebedeu, @chaion07, @netpassprodsr, @bph, @timohaver, @dmivelli, who contributed to the reclassification project.

Props to @melchoyce, @karmatosed, and @beafialho for their design guidance.

Props to @webcommsat and @marybaum for reviewing and editing help of this article.

#docs, #helphub

Reclassification of end-user documentation

The team did a second revision of the first recommended site map because we still found articles that should be moved to the developers documentation. The reason is that we want to keep the end-user documentation as clean as possible of developer jargon and make sure it only provides advice on how to use WordPress not how to alter it with code.

The main goal of article reclassification is to improve search and allow new articles to be added into the existing categories without creating a ‘miscellaneous’ categoryCategory The 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging..

The first site map included 4 main categories and subcategories under each. The new recommendation maintains the 4 main categories, some subcategories have been renamed to better work in the future.

Link to the spreadsheet for better reading

The revision

As mentioned before, the review focused on removing all articles that were developer-focused. Some articles only require content review and move some of the too-technical parts. These parts were not discarded as they are still valuable information and will be moved to DevHub.

Categories and subcategories

The categories for end-user documentation were created to improve search, making it easier for the user to find the information. A secondary goal is to allow a continued learning path.

WordPress overview

WordPress Overview is the first category with 3 subcategories:

  • Where to start
  • FAQs
  • About WordPress

The intention of these subcategories is to provide a starting point for the new user and a quick access to resources to more seasoned users in the form of FAQs. About WordPress provides background information on how to become a contributor, WordPress’ history, etc.

Technical guides

Technical guides is the second category which includes 3 subcategories:

  • Installation
  • Security
  • Maintenance

Although the technical guides include topics that could be seen as developer-focused, there is some basic information that the end-user needs to learn about installing WordPress and working with their hosting companies, as well as maintaining a healthy and secured site.

Support guides

Support guides is the third category, also includes 3 subcategories:

  • The dashboard
  • Publishing
  • Media

These guides are all about the software, getting to know the moving parts of the front end, how to manage and publish content and media. The guides include articles for Classic Editor as well as the 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.

Customization

This is the fourth category and as the titles says, it is all about giving the site or blog the look and feel that the user wants. The number of subcategories increased to 9 and this will help with categorization as the FSE features and new blocks are developed.

  • Appearance
  • Default themes
  • Block Editor
  • Media blocks
  • Text blocks
  • Design blocks
  • Embed blocks
  • Theme blocks
  • WidgetWidget A WordPress Widget is a small block that performs a specific function. You can add these widgets in sidebars also known as widget-ready areas on your web page. WordPress widgets were originally created to provide a simple and easy-to-use way of giving design and structure control of the WordPress theme to the user. blocks

Related tickets

Because there are many moving parts on the site map, everything has been documented in tickets in the documentation issue tracker repository in GH

190Merge articles
192Change article title
373Delete articles from HH
388Move from HH to DH
425Content review duplicated article? Dimension Controls Overview
426FAQ’s content review
427Content review Finding WP Help
429Content review How WP processes post content
430Content review Creating a Search page
442Content review New to WordPress – Where to Start
443Content review Introduction to Blogging
458Content review Comments in WP
469Content review Video shortcodeShortcode A shortcode is a placeholder used within a WordPress post, page, or widget to insert a form or function generated by a plugin in a specific location on your site.
470Content review Weblog client
471Content review WP feeds
473Content review duplicate: WP.org vs WP. com
Tech partsInventory of Technical Parts From End User Docs

Next steps

The #docs team will collaborate with other teams to find the best way to make all the changes. So far, the hosting team is collaborating in moving articles to DevHub.

  • Create new categories and subcategories
  • Change title names to articles and create 301s for older URLs (with the 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. team’s direction)
  • Merge pages and create 301’s
  • Delete pages and redirect to similar content pages/articles.

Other articles written as part of the redesign of HelpHub

Contributions

If you are interested in making any content review on any of the tickets above, reach out to @estelaris on 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/. or leave a comment in the GH ticket.

Props to @femkreations for reviewing the many opened tickets. @milana_cap and @kenshino for reviewing the content. @jonoaldersonwp for providing SEO recommendations.

#helphub

First review on the new Sitemap for HelpHub

Following up on the post Explorations of a new classification for user documentation, we suggested to create 4 pillars (categories) and subcategories. My suggestion is to keep the subcategories to the minimum and add as many articles as needed, this will allow the system to grow as needed.

The 4 pillars in HelpHub

The 4 suggested pillars with their own subcategories are:

  1. WP Overview
    • About WordPress
    • Resources
    • FAQs
  2. Technical guides
    • WordPress installation
    • WordPress multisites
    • Configuration
    • Maintenance
    • Security
    • Troubleshooting
  3. Support guides
    • Get to know the dashboard
    • Publishing
    • Media
  4. Customization
    • Appearance
    • Default themes
    • Classic Editor
    • 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
    • Common Blocks
    • Formatting
    • Layout elements
    • Theme Blocks
    • Widgets
    • Embeds

What has been done

During Google Season of Docs 2020, there was a project to reclassify all the articles, change article titles to follow the new style guide being written at the time and review the content (including links, outdated content, etc).

These are some of title changes given and the team will discuss the next steps to either change the affected URLs or not, but that is for another post.

Due to the rotation of contributors and the team focusing on other issues, the revision of content is still ongoing. If you would like to help out, join a meeting or reach out to @femkreations on 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/, @Femy on Slack and she will guide you.

The new titles and the reclassification has been done. We will continue to include articles that are still to be written, as well as any new article.

The first draft

This is a first draft of the Sitemap and we need your help to make sure articles are in the correct categoryCategory The 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging. or if there is anything else we need to add. You can leave your comments on this post or in the Draft of the Sitemap linked above.

What is up for review

  • Category names
  • Subcategory names
  • Articles classified in the correct category/subcategory

What is not for review

  • The four pillars (the title yes, but we won’t be adding anymore pillars)
  • Order of articles under categories nor order of subcategories (we will review them at a later time)
  • New name titles for articles (these were given during GSoD and have been already reviewed and accepted/rejected by the #docs team)

Other articles written as part of the redesign of HelpHub

If you would like to contribute or have any questions, reach out to @estelaris on Slack or leave a comment.

Props to @milana_cap for peer review.

#helphub

The hashtag and its future in documentation articles

In a previous post, we listed the requirements for the new design for HelpHub. This article is going to discuss one particular requirement, the hashtag at the end of the headlines inside an article.

Basically, we want to remove the # character from the headlines. It may be a radical change but it is necessary for 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). (https://en.wikipedia.org/wiki/Accessibility) reasons.

First of all, let’s mention the requirements to remove or replace the hashtag. The function must be:

  1. Clear on purpose
  2. Easy to read with keyboard
  3. Reduce visual noise
  4. Not polluting the link’s list for screen readers

The hashtag is used at the end of a headline in the articles as seen in the image below. In order to define its future, we need to understand its behavior.

Image of a headline including the hashtag

The hashtag is a link; the anchor is the H2 in the example above. It’s the anchor element, but it’s the link behavior, so it is ambiguous.

Technically, anchor refers to the target of an on-page link. This appears to be a link that gives easy access to identify the URLURL A specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org that will give you access to the current location on the document. That’s…actually kind of complicated.

What about accessibility?

The icon of the character used is not as important as communicating the function of the link. Right now, the # has aria-hidden=true label, so it won’t be read at all.

<h2 id="requirements-on-the-server-side" class="toc-heading" tabindex="-1">Requirements on the server side <a href="#requirements-on-the-server-side" class="anchor"><span aria-hidden="true">#</span><span class="screen-reader-text">Requirements on the server side</span></a></h2>

Link to the code page, line 196

It’s backed by screen reader text that duplicates the heading title, but is also nested inside the heading; this means that the heading text will be read  (e.g.) “Recommended setup Recommended setup”.  It’s creating duplicate text nested inside the heading and does not expose any visible text to explain the purpose.

The options

After some research, I have found several options for replacing and/or removing the hashtag.

  • Adding the link to the heading with a character
  • Making the heading a link
  • Replacing the hashtag with a fly-out menu

Adding the link to the heading, as used by GitHub,  where the link is currently the method to expose the link to that section. It can also be linked from the topics table, at the top of the article. We would have to make sure the implementation is accessible to others besides sighted mouse users.

The link element can be added at the beginning of the headline.
The link element can also be inserted at the end of the headline.

Adding the link to the heading is reasonable and the simplest solution to replace the hashtag, as it will simplify the problem: the functionality will be clear and the visual noise would be reduced considerably.

There are arguments against providing links that point to themselves, however, as it can make a confusing interaction. One of the arguments against this method is that it pollutes the link list on a screen reader. The way the hashtag is presented now, already pollutes the screen reader’s link list.

Replacing the hashtag

Replacing the hashtag with a fly-out menu, as explained by the w3.org. The w3.org recommends using the fly-out menu to meet WCAGWCAG WCAG is an acronym for Web Content Accessibility Guidelines. These guidelines are helping make sure the internet is accessible to all people no matter how they would need to access the internet (screen-reader, keyboard only, etc) https://www.w3.org/TR/WCAG21/.. The fly-out menu removes the need for multiple page loads. The biggest disadvantage is for people with reduced dexterity who can have trouble or it could be almost impossible to operate fly-out menus,which can be prevented with the correct implementation.


Video showing how the fly-out menu operates

The design above would be changed to meet the 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/ design style.

Removing the Symbol

Is removing the symbol entirely an option? Another recommendation from w3.org is placing the interactive elements in an order that follows sequence. This means adding a table of contents which will link to the interactive element, the headline in this case. Basically, the way it is right now but without the hashtag.

Video showing mouse-click to headline and the URL pointing to that headline

References

We would like to hear from you. Do you have another solution that could meet all the requirements?

Props to @ryokuhi, @joedolson, @milana_cap, @jillmugge for peer review.

Update 8 March 2022

We are moving the discussion to a meta ticket to discuss options and accessibility.

#accessibility, #docs, #helphub

Summary for Docs Team Meeting: January 27, 2020

Facilitator: @kulsumsiddique

Attendance: @kenshino, @bph, @felipeelia, @kulsumsiddique, @audrasjb, @ibdz, @wpza, @felipeloureirosantos, @nullbyte, @kafleg, @atachibana, @nobnob

Note-taker: @audrasjb

Next week Facilitator: @kenshino (but invite for other meeting facilitator is open, please comment below if interested)

Team workflow and badges

@felipeelia: workflow docs are being constructed on TrelloTrello Project management system using the concepts of boards and cards to organize tasks in a sane way. This is what the make.wordpress.com/marketing team uses for example: https://trello.com/b/8UGHVBu8/wp-marketing.. @milana_cap is the one to ask for access if needed.

Badges are being discussed in this P2 post. The contributor badge has been discussed for a while now, trying to reach a number of X micro contributions. On his last comment there, @felipeelia suggested to give the badge right away, just as in CoreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. 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.. @bph added that there is precedent on other teams and make the contributor badge seen right away: it’s the best onboarding tool we have.

@bph proposed a list of elligible contributions:

  • Fix an article
  • Create meeting notes
  • facilitate a meeting
  • reporting an issue on the comment form?
  • Creating a PR for GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/ docs
  • user notes on code reference
  • write an article on HelpHub
  • update an article on HelpHub
  • migrate a page to DevHub
  • Report an issues

@kenshino shared some worries about relevancy: “if we say that fixing a typo is fine – we’ll have a rush of requests to do that to farm badges”. Indeed, Core and Meta have automated system to give props to people who contribute on TracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub.https://core.trac.wordpress.org/., based on commit messages. There is no such system for Docs.

@felipeelia argued that 1) People receive core/meta badges sending a 1-line patch ; 2) Coming in to Docs 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/. team and reporting a small typo does require some effort. @bph added that working out how to communicate a fix to the Docs team is a significant step. even if the contribution is just a typo fix. @kenshino agreed, but the team must keep an eye on abuse to tighten those rules if needed.

Regarding Team Badges, @kenshino proposed to set up a sheet and to give edit access to people that are running projects within the Docs Team.

HelpHub Survey

Reminder from previous meeting discussions: The goal is to build the questions of the survey with the general theme being “How do you think we can improve the WordPress documentation?”. Some questions using the likert scale to track how good it is now so the Team can repeat the survey in the future. Some open fields to get proper feedback so it’s possible to define future projects better. That would be great for this survey to be ready for 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. Asia, in less than one month.

@atachibana is coordinating the effort. @bph proposed to assist on this task.

Step 1 is to start a Google Doc in the team’s shared folder.

This survey and the Docs team focus for WordCamp Asia are set to be the next meeting focus.

@bph proposed to draft a 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/. post to ask for questions proposals. @kenshino proposed to review this draft.

#contributor-day, #helphub