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, reporting and fixing bugs and requesting and implementing new features, helping the community...

New contributors

Where should I start?

Where should I ask questions?

What are "good-first-issues"?

How do I claim an issue?

How do I start a pull request?

Request new feature

Submit bug report

Contribute code

Write documentation

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.

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

• Dependencies
• Environment variables

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

• Pull request guidelines
• Testing

Documentation

• Write documentation
• Documentation style guide

Triage

Bug triaging and issue curation

Triage team

A typical workflow for triaging issues

Maintenance

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