Contribute

Thank you for your interest in helping to improve Matplotlib!

There are various ways to contribute: optimizing and refactoring code, detailing unclear documentation and writing new examples, helping the community, reporting and fixing bugs and requesting and implementing new features...

Submit a bug report

We have preloaded the issue creation page with a Markdown form that you can use to provide relevant context. Thank you for your help in keeping bug reports complete, targeted and descriptive.

Report a bug

Request a new feature

We will give feedback on the feature proposal. Since Matplotlib is an open source project with limited resources, we encourage users to then also participate in the implementation.

Request a feature

We welcome you to get more involved with the Matplotlib project! If you are new to contributing, we recommend that you first read our contributing guide. If you are contributing code or documentation, please follow our guides for setting up and managing a development environment and workflow. For code, documentation, or triage, please follow the corresponding contribution guidelines.

New contributors

Where should I start?

Where should I ask questions?

How do I work on an issue?

How do I start a pull request?

Contribute code

Write documentation

Build community

Development environment

Install

• Setting up Matplotlib for development
  • Fork the Matplotlib repository
  • Retrieve the latest version of the code
  • Create a dedicated environment
  • Install Dependencies
  • Install Matplotlib in editable mode
  • Verify the Installation
  • Install pre-commit hooks

Workflow

• Development workflow
  • Workflow summary
  • Update the main branch
  • Make a new feature branch
  • The editing workflow
  • Open a pull request
  • Update a pull request
  • Manage commit history
  • Automated tests

• Troubleshooting

Policies and guidelines

Code

• Coding guidelines
• API guidelines
• Testing

Documentation

• Write documentation
• Documentation style guide
• Guidelines for assigning tags to gallery examples

Triage And Review

• Bug triaging and issue curation
• Pull request guidelines

Maintenance

• Release guide
• Community management guide
• Dependency version policy
• Matplotlib Enhancement Proposals