Proposal: A WordPress Project Contributor Handbook

There have been many times over the past six years where I reviewed new content going into a team’s handbook, and thought that it really should be in a big “WordPress Project Handbook”. It’s generally content around underlying philosophies or commitments to do (or not do) something, but ultimately shared expectations of how we, as contributors, work together, who we want to build our products for, and the WordPress interpretation of modern, open sourceOpen Source Open Source denotes software for which the original source code is made freely available and may be redistributed and modified. Open Source **must be** delivered via a licensing model, see GPL. best practices.

As I’ve watched many working groups come together to create sections of this handbook, it occurred to me that speaking “on behalf of WordPress contributors” is never an easy task, and certainly not one that is made easier by trying to create a handbook by committee. That doesn’t make a handbook like this less vital, but it does make the responsibility much more heavy.

That level of responsibility is something that falls into my job description, so I will take on the responsibility for a first draft. I plan to include the following sections:

  • Community Code of Conduct
  • 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) Policy
  • Diversity and Inclusion Policy
  • Privacy Policy
  • Conflict of Interest Policy
  • Code of Ethics

This would be a handbook outside of individual team handbooks, and will grow to include other foundational content (i.e. the GPLGPL GPL is an acronym for GNU Public License. It is the standard license WordPress uses for Open Source licensing https://wordpress.org/about/license/. The GPL is a ‘copyleft’ license https://www.gnu.org/licenses/copyleft.en.html. This means that derivative work can only be distributed under the same license terms. This is in distinction to permissive free software licenses, of which the BSD license and the MIT License are widely used examples. primer, open source leadership resources, etc.).

Next Steps

  • I will coordinate a v1 of this handbook as a starting point.
  • I will share the v1 with former members of those working groups, so that we don’t lose that institutional knowledge.
  • A call for feedback will be posted so that refinements can be made.

Documentation Team Update – May 9, 2022

Documentation Issue Tracker stats.

Current state

Past 7 days

1 Issue closed:

2 Unresolved conversations:

6 active projects:

#docs

Themes team update May 10, 2022

Theme directory stats

Currently,

  • 0 new tickets are waiting for review.
    • 0 tickets are older than 4 weeks
    • 0 tickets are older than 2 weeks
    • 0 tickets are older than 1 week
    • 0 tickets are older than 3 days
  • 25 tickets are assigned.
    • 0 tickets are older than 4 weeks
    • 0 tickets are older than 2 weeks
    • 5 tickets are older than 1 week
    • 11 tickets are older than 3 days
  • 1 are approved but are waiting to be made live.

In the past 7 days,

  • 306 tickets were opened
  • 297 tickets were closed:
    • 285 tickets were made live.
      • 13 new Themes were made live.
      • 272 Theme updates were made live.
      • 1 more were approved but are waiting to be made live.
    • 12 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: 3

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 Stats

  • 2 Block themes is live in past 7 days.
  • Currently, 4 Block theme are under reviewing.

HelpScout Stats

In the past 7 days,

Email Conversations 06Messages Received 06
Replies Sent 07Emails Created 00
Resolved 07Resolved on First Reply 86%

Plugin Review Team Status: 9 May ’22

The higher than usual number of closures is due to email bounces. We’ve got about 200 left to process. Some may have multiple plugins.

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 Status Change Stats

  • Plugins requested : 112
  • Plugins rejected : 11
  • Plugins closed : 197
  • Plugins approved : 37

Plugin Queue Stats (current)

  • Plugins in the queue (new and pending)* : 461
  • → (older than 7 days ago)** : 368
  • → (2022-05-02 – 2022-05-09) : 60
  • → (new; not processed or replied to yet)* : 25
  • → (pending; replied to)* : 436

Help Scout Queue Stats

  • Total Conversations: 847
  • New Conversations: 674
  • Customers: 576
  • Conversations per Day: 94
  • Busiest Day: Thursday
  • Messages Received: 966
  • Replies Sent: 821
  • Emails Created: 196

#plugins

Documentation Team Update – April 25, 2022

Documentation Issue Tracker stats.

Current state

Past 7 days

5 Issues closed:

27 Issues opened:

7 Unresolved conversations:

6 active projects:

#docs

Big Picture Goals 2021

During 2020’s State of the Word, Matt reminded us of our overall roadmap 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/. Much of that roadmap is on a multi-year timeline, and it can be hard to know what’s next with such a distant North Star. This post contains some near-stars for the year, but there are some things you should know before you read them.

These are intentionally broad

There is more to WordPress’ success than the code we write, or the open sourceOpen Source Open Source denotes software for which the original source code is made freely available and may be redistributed and modified. Open Source **must be** delivered via a licensing model, see GPL. freedoms we share. While the goals below are focused on shippable projects, I understand that there are supporting contributions (translations, testing/triage, 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), support, etc) that are part of these project goals.

These are intentionally incomplete

There are always small projects that arise over the course of our year. And there are big projects that we move forward in pieces over the course of multiple years. This project is too big for me to see everything all the time, and I rely on the information from team reps and the vision from project leadership to help navigate any surprises.

Just because a project isn’t written here, doesn’t mean it is forgotten or has no value to our overall success.

The Big Picture

  1. Full site editing: Bring into the Gutenberg 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, and subsequently WordPress CoreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress., the ability to edit all elements of a site using Gutenberg blocks. This will include all in-progress features designed to help existing users transition to Gutenberg as well. Scope/Timeline: MVPMinimum Viable Product "A minimum viable product (MVP) is a product with just enough features to satisfy early customers, and to provide feedback for future product development." - WikiPedia in the plugin by April 2021, v1 in Core by WordPress 5.8.
  2. LearnWP: Enable WordPress skills-leveling by providing workshops, pre-recorded trainings, and self-serve learning opportunities on learn.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/Scope/Timeline: regularly publish new workshops and lesson plans, maintain a high pass rate on workshop quizzes to establish learner success and comprehension.
  3. Contributor tools: Decrease the manual overhead of maintenance work for teams through better tooling. Scope/Timeline: Varied, and pending additional testing.

How can you help?

As I mentioned above, I know that our code isn’t the only measure of our success. If you already know what sort of contribution you’d like to make, you can check out this list of teams (with links to their community sites) and team reps. If you’re not yet sure, here are the areas that each team falls into:

  • Development, Technology, Code: Core/Editor, Mobile, CLICLI Command Line Interface. Terminal (Bash) in Mac, Command Prompt in Windows, or WP-CLI for WordPress./Tide, Security
  • Design, Product, UXUX UX is an acronym for User Experience - the way the user uses the UI. Think ‘what they are doing’ and less about how they do it./UIUI UI is an acronym for User Interface - the layout of the page the user interacts with. Think ‘how are they doing that’ and less about what they are doing.: Design, Accessibility, Test, Triage
  • Community, Extending WP, Education: Community, Themes, Plugins, Polyglots, Training
  • Contributor Experience: 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., Docs, Hosting, Privacy
  • Communications: Marketing, Support, WPTV

A Note on Specialized Groups

There are a couple of coordinated efforts that provide essential support to the progress of multiple teams.

  • Triage: The triage effort happens across multiple teams and has two purposes. One purpose is to make sure tickets are sorted and have all the elements needed for someone to work on them. The second purpose is to determine priority. Not everyone has the information to set priority, but anyone can help sort and replicate reported bugs!
  • Test: The testing effort also happens across multiple teams and has two purposes. One purpose is to try out features before they get to our users. The second purpose is to bring high quality feedback into our process early. A lot of that coordination happens on make.wordpress.org/test, but there are also frequently calls to participate on make.wordpress.org/core.

#goals

What’s new on LearnWP in March 2022

In March 2022, the Training team published the following resources on Learn.WordPress.org

📋 Lesson Plans

Lesson plans are ideal for 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. organizers or presenters and other trainers to use when facilitating a presentation.

🖥 Workshops

These short, free workshops are ideal for on-demand direct learners.

  • Adding a Site Tagline to Block Themes and manage a 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. template part when installing a block theme.
  • Manage Settings: Privacy – this workshop will take you through how to add a new privacy policy or adapt a template for your website.
  • Managing Settings: Permalinks – how to configure the WordPress Permalink Settings and use a redirect 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 for established permalinks.
  • Intro to the Site Editor and Template Editor – an overview of how to access and use the new Site Editor and Template Editor features. With the Site Editor, if you use the block editor, you can build your entire site with blocks. The Template Editor enables allows block editor users to edit and create templates used by a page or post.

🗓 Social Learning Spaces

The WordPress Social Learning meetup focuses on helping users at all levels learn more about using the software and to help others use it too. It is part of the resources available through Learn WordPress. You can sign-up for events for free.

Events list


➕ Contribute

These resources are available to use and promote. If you would like to take part in the sprints for Learn WordPress, join the Training Team meetings. The March 2022 Sprint post.

#learnwp

Documentation Team Update – April 12, 2022

Documentation Issue Tracker stats.

Current state

Past 7 days

1 Issue closed:

2 Issues opened:

7 Unresolved conversations:

6 active projects:

#docs

Our Three Big Ideas for 2022!

2022 is going to be a big year for WordPress as we get more and more people to use the new editor (and as a result make the editor even better)! We’re also going to be gearing up for a our 20th anniversary next year 😮 —I can’t believe this project has been around for so long!

For easy tracking, here are the big focuses for this year:

  1. Drive adoption of the new WordPress editor (though education, awareness, and better content for new WordPressers).
  2. Support open sourceOpen Source Open Source denotes software for which the original source code is made freely available and may be redistributed and modified. Open Source **must be** delivered via a licensing model, see GPL. alternatives for all site-building necessities (through supporting Openverse, our suite of directories, and the way we present ourselves to the world).
  3. Open Source stewardship (through maintenance of our community programs, leading by example, and other project as we find them).
  4. Bonus: Get ready for WP20!

Read more about these big ideas and more specific goals for each or, if you’re a team repTeam Rep A Team Rep is a person who represents the Make WordPress team to the rest of the project, make sure issues are raised and addressed as needed, and coordinates cross-team efforts., send me your thoughts on how your teams can join the effort!

#goals #planning

Plugins team update, October 9, 2014

Repository stats for the week:

Plugins requested : 187
Plugins rejected : 28
Plugins closed : 25
Plugins approved : 132

61 items currently in the queue, 39 unanswered and 3 older than a week.

4631 commits to the repo (1004819-1000188). @otto42 is our one-millionth customer, with a well-earned changeset: https://plugins.trac.wordpress.org/changeset/1000000

We currently have 19 open support tickets, with 3 older than a week.

#plugins