FAQ for New Contributors

This Frequently Asked Questions list comes from questions that new Core contributorsCore Contributors Core contributors are those who have worked on a release of WordPress, by creating the functions or finding and patching bugs. These contributions are done through Trac. https://core.trac.wordpress.org. ask in New Contributors Meetings.

Look for the list to grow over time as more questions get asked and answered.

How do I get started? How do I get started?

There’s a lot of documentation out there. You’ll want to get a sense of what it covers and where the various parts and pieces live, start by going through it with an eye toward figuring out where things are, how they’re structured and what the topics are that particularly appeal to you.

You’ll probably forget the details, but you’ll know you can find things again with a search. Go ahead and bookmark those pages for further reference.

You’ll also want to set up 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 join a few channels.

Start going to the scheduled meetings just to get an idea of how things get done:

  • what each group talks about,
  • what gets a lot of attention across groups and, therefore,
  • what the priorities are.

You also will want to go through the posts on Make WordPress Core to read meeting summaries from a while back, for context and to see how things get priority. Along with your other reading, you’ll start to get an idea of what the focus areas are and where you’d like to focus your time.

Top ↑

Are there specific people who can help me get started? Are there specific people who can help me get started?

There are. @desrosj, @flixos90, @stevenkword, @adamsilverstein, @welcher and @SergeyBiryukov run the New Core Contributors Bimonthly Chats on Slack; plan to start going to a few. The schedule is on Make/Meetings, and they’ll welcome your questions.

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.” them on Slack. If you have questions after a meeting, or you have a question you’d rather not ask publicly, you’re more than welcome to ping them throughout the week.

Top ↑

Given that most tickets already have a patchpatch A special text file that describes changes to code, by identifying the files and lines which are added, removed, and altered. It may also be referred to as a diff. A patch can be applied to a codebase for testing. submitted, where should I start on TracTrac An open source project by Edgewall Software that serves as a bug tracker and project management tool for WordPress.? Given that most tickets already have a patch submitted, where should I start on Trac?

It’s true that some tickets already have patches.

But patched rarely means finished. Generally, patches need review and feedback from other contributors. And from component maintainers.

Sometimes a first patch takes significant edits. Sometimes you might see multiple patches at the same time, iterating on a solution or exploring a variety of approaches.

That’s why you see tickets that already have a patch, and why we don’t just automatically commit them. They still need testing, plus all those reviews and feedback we just mentioned. In fact, testing an existing patch and giving feedback is an excellent way for you to get involved, and a critical step in the process that moves them forward.

So once you’ve done your thing, whether patching or testing or reviewing, how do you get more eyes on a ticketticket Created for both bug reports and feature development on the bug tracker.?

The ticket comments are your best friend. When you leave a comment, the ticket automatically pings everyone on the ticket: its owner, people who are watching the ticket and, best of all, one or more relevant component maintainers. And they have every interest in the world in getting that ticket committed and merged – it’s what we do as contributors to WordPress.

You can also bring it up in #core on Slack any time outside of any ongoing meeting (or in the open floor section of the weekly dev meeting).

Top ↑

Are there specific priorities or components that need more help than others? Where can I help the most? Are there specific priorities or components that need more help than others? Where can I help the most?

Start with the list of good first bugs.

These are well-contained tasks designed to help you get familiar with WordPress coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. code, processes and contributing. And they likely won’t send you down a rabbit hole.

If nothing catches your eye on that list, start looking at the tickets marked as needs-patch in the current milestone (5.4 at this writing). They have a higher priority and need the most attention.

You can run a query for tickets with no patch: https://core.trac.wordpress.org/tickets/no-patch

Top ↑

How can I get involved with Bug Gardening? Can I pick any ticket that seems interesting? How can I get involved with Bug Gardening? Can I pick any ticket that seems interesting?

Bug Gardening is a great way to contribute. And, yes. Feel free to pick any ticket that seems interesting.

Do start by reading the handbook entry on Bug Gardening.

There’s a Triagetriage The act of evaluating and sorting bug reports, in order to decide priority, severity, and other factors. Team that’s looking for contributors. Its mission is to go through every open ticket in Trac to review and triage each one, aiming to lower the absolute number of tickets in the short term and keep that number low going forward.

Some recommended reading on that:

Top ↑

While I browsed Trac, I replied to some tickets. Where can I find them again? While I browsed Trac, I replied to some tickets. Where can I find them again?

Bookmark this: https://core.trac.wordpress.org/my-comments

Top ↑

How do core maintainers choose what goes into a next releaseRelease A release is the distribution of the final version of an application. A software release may be either public or private and generally constitutes the initial or new generation of a new or upgraded application. A release is preceded by the distribution of alpha and then beta versions of the software.? How do core maintainers choose what goes into a next release?

Generally, the release leads and component maintainers have some tasks they would like to prioritize for the release. For reference, see the proposed scope for 5.4.

Plus, from Trac, we merge a lot of small bugbug A bug is an error or unexpected result. Performance improvements, code optimization, and are considered enhancements, not defects. After feature freeze, only bugs are dealt with, with regressions (adverse changes from the previous version) being the highest priority. fixes and enhancements across every component.

Also, in the earliest weeks, there’s an open call for tickets so teams can get a better idea of what’s important to the community. Then, component maintainers and committers go over the results and add tickets that makemake A collection of P2 blogs at make.wordpress.org, which are the home to a number of contributor groups, including core development (make/core, formerly "wpdevel"), the UI working group (make/ui), translators (make/polyglots), the theme reviewers (make/themes), resources for plugin authors (make/plugins), and the accessibility working group (make/accessibility). sense, based on the overall priorities of the release.

Top ↑

What do all those keywords on the tickets mean? What are they for? What do all those keywords on the tickets mean? What are they for?

See Trac workflow keywords glossary.

Top ↑

How do I make patches with 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/.? How do I make patches with Git?

See these articles for more information on creating patches with Git:

Find out more on the Contributing with Code Handbook page.

Top ↑

How should I name my patches? How should I name my patches?

If there are other patches on the ticket, add a numeric increment to your version, separated with a dot. Otherwise, name your patch after the ticket number.

For example, if your patch is the first for ticket 12345, name your file 12345.diff. If there are 2 other patches, name your file 12345.2.diff.

If you want, you can include a very shortened purpose to your filename.

Top ↑

Where can I learn more about working with Trac? Where can I learn more about working with Trac?

See the related Core Handbook Page.

Also, check the bug scrub schedule and go to some scrubs. You’ll learn a lot by doing!

Last updated: