Themes Team Meeting Notes – January 23, 2024

Howdy Mates, welcome to 2024!

The meeting notes are from the themes team discussion.

Attendees:

:one: Weekly updates

In the past 7 days,

  • 688 tickets were opened
  • 715 tickets were closed
    • 701 tickets were made live.
      • 55 new Themes were made live.
      • 646 Theme updates were made live.
      • 0 more were approved but are waiting to be made live.
    • 14 tickets were not approved.
    • 0 tickets were closed-newer-version-uploaded.

Note: These stats include both the new theme tickets and updated theme tickets as well.

Number of reviewers: 4 (@acosmin@kafleg@fahimmurshed@vowelweb)

The themes team published weekly updates about tickets and HelpScout emails. Here is the theme statistic for the past 7 days. The most current stats can be found here.

17 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. theme is live in the last 7 days.

This discussion was started based on the meta ticket created by @iamtakashi.

After the discussion, we concluded that the best action is to message the team reps about multiple submissions. Then, themes team reps will handle those on a case-by-case basis.

:three: New requirements for settings pages & onboarding in themes

@Travel_girl created this ticket in 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.. The ticket was just to share the update of what she is doing. But during the meeting, we also discussed how we can effectively treat 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)-ready themes.

@greenshady said, “A11yAccessibility 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)(Accessibility) has always been an issue because of the lack of reviewers doing a11y-specific reviews. We used to have a couple of reviewers specifically for that tag. The best way to help in this area is to get involved in the review process, I think. Unless there are some automated tools that we could look into.”

And I requested everyone to report the themes that are not A11y ready but have accessibility-ready tag.

:four: Provide information about committing theme updates directly to 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/.

@dufresnesteven created this meta ticket.

@greenshady asked, “Should we tackle this in the Theme Handbook or the Make Themes Handbook?”. I said, ” It can be in the Make themes handbook. The theme handbook is for general and this process is for theme authors only.” And Justin agreed on it.

Also, the meta team is looking for this ticket and we’ll soon confirm the text and update the email template.

:five: Open floor

The updated Advanced Topics chapter for the Theme Handbook is nearly ready. I plan to start moving the docs over to DotOrg as post drafts today: https://github.com/WordPress/Documentation-Issue-Tracker/issues/1416

If you are attending WCAsia in Taipei and want to lead the themes table or patterns table, do let me know. We are looking for 1 table lead for themes and 2 table leads for patterns.

#meeting, #meeting-notes, #themes-team

Themes team meeting agenda for January 23, 2024

The themes team convenes on the second and fourth Tuesdays of each month. The first meeting for this month is scheduled for January 23.

The meeting takes place in the #themereview channel on 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/. and you need an account to participate.

Channel: #themereview | Time: Tuesday, January 23, 2024, 15:00 UTC

In addition to the predetermined agendas, we allocate time at the end for an open floor session where you are welcome to ask questions or share any themes-related information.

We highly encourage all members, as well as anyone with an interest, to participate. If you have specific agenda items you would like to include, please feel free to add them in the comment section below.

Meeting Agendas

  • Weekly updates
  • Allow larger theme authors to submit multiple themes (Meta ticket)
  • The current state of 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)-ready Themes (Meta ticket)
  • Provide information about committing theme updates directly to 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/. (Meta ticket)
  • Open Floor

Looking forward to seeing you at the meeting!

#agenda, #meeting, #themes-team

X-post: Twenty Twenty-One, Twenty Twenty, and Twenty Seventeen updates now available

X-comment from +make.wordpress.org/core: Comment on Twenty Twenty-One, Twenty Twenty, and Twenty Seventeen updates now available

X-post: Call for Mentees & Mentors: Contributor Mentorship Program Cohort #2 (2024 Q1)

X-comment from +make.wordpress.org/community: Comment on Call for Mentees & Mentors: Contributor Mentorship Program Cohort #2 (2024 Q1)

New Block-Focused Theme Handbook Docs and What’s Coming in 2024

I hope everyone had a good break over the holidays. I know I caught up on some much-needed rest and am now excited to get back into the swing of doing fun things with WordPress themes.

Now it’s time to discuss the current progress and next steps of one of our biggest projects of 2024: the Theme Handbook overhaul.

What Is the Theme Handbook Overhaul?

This is a project that the theming community agreed to take on last year. Its goal was to give the Theme Handbook content a refresh, primarily focusing on modern 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. theme development.

You can read the initial proposal and previous project updates here:

The ongoing work is tracked via the Theme Handbook Overhaul tracking ticket 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 Project’s Progress

In 2023, five new/updated chapters were published in the handbook:

The primary focus of these first five chapters is to introduce theme creators to the block theming system. Most of this documentation is 100% new. If you haven’t browsed the handbook for a while, now is a great time to catch up!

There are also eight draft articles that have yet to be published.

In terms of “chapter count,” that’s nearly half of the project. But if looking at the actual new content that needed to be created, it’s probably closer to 2/3 of the way toward the finish line.

The Next Steps

The plan is to complete the entire overhaul by the end of Quarter 2 (June 30) of 2024. I believe we can get the bulk of the new content published or drafted in Q1, leaving most of Q2 for final touches and cleanup.

In the coming months, there are still six chapters left to create or update:

  • Patterns (recently added to the outline)
  • Classic Themes
  • Advanced Topics (mostly drafted)
  • 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)
  • Guides
  • Contributing

The Classic Themes, Advanced Topics, and Guides chapters are mostly content updates and a bit of reorganization. These are what I’d call “good first issues” for anyone who wants to contribute but is not ready to write a full documentation article on their own.

The Patterns chapter was recently added to the outline because patterns are a first-class tool in WordPress that will only continue to become more powerful. There is currently a single Block Patterns doc, but it needs to be expanded into multiple articles that showcase each pattern feature. If you like to tinker with patterns, this could be a fun chapter to contribute to.

One area where the project really needs a volunteer is for the Accessibility chapter. It’d be great to have an expert in the field to review and expand upon the existing documentation.

Get Involved

To get involved, all you need to do is:

You can reach out for help with this in the #docs or #themereview 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/. channels. You can also 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.” me (@greenshady) directly if you have questions.

Props to @kafleg for reviewing this post.

#theme-documentation