Becoming involved¶
conda-forge is a community-driven effort of cross-platform packaging and relies on volunteers to sustain and improve.
We encourage you to contribute to conda-forge. You can do so in several ways:
Help update and maintain packages.
Suggest or implement improvements for our infrastructure.
Improve the documentation¶
The conda-forge
documentation is version-controlled in the
conda-forge.github.io repository on GitHub. The source
text is stored in the src/ subdirectory of this repository
(not the docs/ subdirectory) and
is formatted using Python’s reStructuredText system.
You can propose quick edits directly through the GitHub website if you have a GitHub account — for instance, this link will take you directly to a web-based editor for this very webpage. In general, the file corresponding to each page in the GitHub browser has a little pencil icon in its top-right corner that lets you open it up for editing.
We are glad to know that you would like to contribute to the conda-forge
documentation. If you are new to the conda-forge community, follow the steps below to make your first contribution:
Clone this fork onto your local machine:
git clone https://github.com/<your-username>/conda-forge.github.io.git
Create a new branch deriving from
main
to do your work:
git checkout -b <new-branch-name>
Run the following commands:
conda env create -f ./.ci_scripts/environment.yml
conda activate conda-forge-docs
cd newsfeed && pip install --no-deps .
cd ../src
Make your changes and run the following command to check them:
make html
You can check the changes locally by opening the html files in
src/_build/html
.
Add and commit your changes:
git add .
git commit -m "your commit message"
Submit a pull request to the main repository proposing your changes.
Happy contributing!