Contributing to Conda
Thank you for your interest in improving conda! Below, we describe how our development process works and how you can be a part of it.
Already know how to contribute and need help setting up your development environment? Read the development environment guide here
Hosted on GitHub
All development currently takes place on GitHub. This means we make extensive use of the project management tools they provide such as issues and projects.
Code of Conduct
When you decide to contribute to this project, it is important to adhere to our code of conduct, which is currently the NumFOCUS Code of Conduct. Please read it carefully.
Conda Contributor License Agreement
To begin contributing to this repository, you need to sign the Conda Contributor License Agreement (CLA). In case you’re new to CLAs, this is a rather standard procedure for larger projects. Django and Python for example both use similar agreements.
Click here to sign the Conda Contributor License Agreement.
A record of prior signatories is kept in a separate repo in conda’s GitHub organization.
Ways to contribute
Below are all the ways you can get involved in with conda.
Bug reports and feature requests
Bug reports and feature requests are always welcome. To file a new issue, head to the issue form.
It should be noted that
conda-build issues need to be filed separately at
its issue tracker.
For all other types of issues, please head to Anaconda.org’s “Report a Bug” page. For even more information and documentation on everything related to Anaconda, head to the Support Center at Anaconda Nucleus.
Before submitting an issue via any of these channels, make sure to document it as well as possible and follow the submission guidelines (this makes everyone’s job a lot easier!).
Contributing your changes to conda
Here are the steps you need to take to contribute to conda:
Signup for a GitHub account (if you haven’t already) and install Git on your system.
Sign the Conda Contributor License Agreement.
Fork the conda repository to your personal GitHub account by clicking the “Fork” button on https://github.com/conda/conda and follow GitHub’s instructions.
Work on your proposed solution. Visit this page if you need help getting your development environment setup
When you are ready to submit a change, create a new pull request so that we can merge your changes to our repository.
Issue sorting is how we filter incoming issues and get them ready for active development. To see how this process works for this project, read “The Issue Sorting Process at conda”.
The project maintainers are currently not seeking help with issue sorting, but this may change in the future
Conda capitalization standards
Conda should be written in lowercase, whether in reference to the tool, ecosystem, packages, or organization.
References to the conda command should use code formatting (i.e.
If the use of conda is not a command and if conda is at the beginning of a sentence, conda should be uppercase.
Beginning a sentence:
Conda is an open-source package and environment management system.
conda installcan be used to install packages.
Conda in the middle of a sentence:
If a newer version of conda is available, you can use
conda update condato update to that version.
You can find conda packages within conda channels. The
condacommand can search these channels.
In titles and headers
Titles and headers should use the same capitalization and formmating standards as sentences.
Links should use the same capitalization conventions as sentences. Because the conda docs currently use reStructuredText (RST) as a markup language, and RST does not support nested inline markup, documentation writers should avoid using code backtick formatting inside links.