Pants v2: The ergonomic build system

Welcome to the Pants v2 documentation hub!

Pants v2 is a fast, scalable, user-friendly build system for growing codebases. It's currently focused on Python, with support for other languages coming soon.

Here you'll find guides to help you get started with Pants v2, comprehensive documentation on how to configure, run and customize Pants v2, and information on how to get help from the Pants community.

Get Started

Contributing to Pants

Who is behind Pants?

Pants is developed by a community of people who are passionate about improving the craft of software engineering. We come from diverse backgrounds and interests, but share the goal of creating the best tools to support more effective and enjoyable software development.

Pants Build is registered as a 501c(6) non-profit in California, whose purpose is to maintain the Pants project's assets, such as its CI resources.

Can I join this community?

Absolutely! We welcome the involvement of anyone who shares our passion for creating state-of-the-art software development tooling.

Joining the Pants community can be as simple as jumping into one of our Slack channels for a chat. We welcome questions, comments, opinions, jokes and memes on anything related to software development tooling and practices. We'd love to hear about your current or planned uses of Pants, and, of course, we are happy to help onboard you and your team!

There are no bad questions. We require only that all community members abide by our Code of Conduct.

How can I contribute to Pants?

Contributions come in many forms, and we appreciate all of them! Examples include reporting or fixing bugs, suggesting or adding new features, improving documentation, identifying confusing or insufficient error messages, answering user questions on Slack, helping with developer outreach, and more.

Whatever your area of expertise and your skill level, there may be valuable contributions you can make. Are you a graphic designer? A technical writer? Do you know how to make videos? There might be a cool contribution in your future. You may even end up with some cool Pants swag for your efforts!

We try and make contribution easy. For example, you can suggest documentation fixes by clicking on the Suggest Edits link on any page. And you can report bugs by opening a GitHub issue. If you want to hack on the Pants codebase itself there is a helpful guide.

For some contributions, such as adding new features, the best place to get started is our Slack workspace. You can make suggestions, solicit feedback and connect with like-minded contributors. That way we know who is working on what, and can help you avoid duplicating efforts or hitting known pitfalls.

If you want to contribute but don't have a specific plan or idea, we can help you discover some fruitful areas to focus on. There is plenty to do!

How is the community structured?

We welcome contributions from anyone, and we recognize consistent contribution with special statuses.

Maintainers

Pants has a core group of Maintainers: trusted people with a long-term interest in Pants who have made regular contributions for some time and plan to continue to do so. Maintainers conduct code reviews of pull requests, and may be granted extra permissions, such as write access to the Pants repository, as needed.

Contributors

Anyone who has made a few contributions of any kind, and has an ongoing interest in the Pants project, may be nominated by a Maintainer to become a Contributor. Contributors may be granted extra permissions, such as the ability to assign issues, but these stop short of full Maintainer permissions. Contributors with a continuing track record of contribution may be nominated to become Maintainers.

Maintainers Emeritus

Sometimes a Maintainer may need to step back to less intensive involvement. To recognize their past contributions, they retain the honorary Emeritus status.

Officers

This is a subset of the Maintainers that are officers of the Pants Build 501c(6) organization. Their role is primarily bureaucratic, as well as a formality required by the State of California. They don't have extra voting power over the other Maintainers.

How are decisions made?

We strive to arrive at decisions - about priorities, technical choices and others - by consensus where possible. If we cannot achieve consensus, we have a process in place for putting decisions to a vote among the Maintainers. We avail ourselves of this process extremely rarely.

Updated 11 days ago


Contributing to Pants


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.