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:

• Contribute new packages.
• Help update and maintain packages.
• Suggest or implement improvements for our infrastructure.
• Help improve the documentation.

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 docs/ subdirectory](https://github.com/conda-forge/conda-forge.github.io/tree/main/docs of this repository and is formatted using Docusaurus' Markdown.

Editing the documentation directly through Github

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.

Editing the documentation locally

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:

1. Fork the conda-forge.github.io repository.
2. Clone this fork onto your local machine:
   • git clone https://github.com/<your-username>/conda-forge.github.io.git
   • cd conda-forge.github.io
3. Create a new branch deriving from main to do your work:
   • git checkout -b <new-branch-name>
4. Run the following commands:
   • conda env create -f ./.ci_scripts/environment.yml
   • conda activate conda-forge-docs
5. While writing your new documentation, you can use the live preview mode with:
   • npm install to make sure node_modules is up-to-date
   • npm run start to start the live preview. Every time you save a file, the changes will be reflected instantaneously!
6. Once ready, you can also check how the production build would look like with the command:
   • .ci_scripts/update_docs You can check the changes locally by opening the html files in build/ or running:
   • python -m http.server --directory build/
7. Add and commit your changes:
   • git add .
   • git commit -m "your commit message"
8. Submit a pull request to the main repository proposing your changes.

Happy contributing!

Writing guidelines

Some basic writing guidelines should be kept in mind before you start contributing:

1. Identify your audience and understand their skill level.
2. Match the technical language with the audience's skill level proficiency.
3. Try to keep it simple. In case you have to use a lot of complicated terms, provide a glossary of key terms.
4. Address the audience directly as the user(s).
5. While mentioning an action, use the "command" form of the verb: "Choose an option from the menu and press Enter."
6. For references, provide links to related content.
7. Use headings and bullet points, which makes it easier to read.
8. Avoid ambiguous titles. The title should include a clear description of the page's subject.
9. Check your spellings and grammar.
10. conda-forge should always be spelt in lowercase, hyphenated, and without backticks. It should only be backticked when used as an identifier (e.g. the Anaconda.org channel, the Github organization, etc).