Contribution Guidelines

Thanks for your interest in contributing to our project. This page will give you a quick overview of how things are organized and, most importantly, how to get involved. Everyone is welcome to contribute, and we value everybody's contribution.

Table of contents

1. Add a project
2. Update a project
3. Improve metadata collection
4. Improve markdown generation
5. Create your own best-of list
6. Code of conduct

Add a project

If you like to suggest or add a project, choose one of the following ways:

• Suggest a project by opening an issue: Please use the suggest project template from the issue page and fill in the requested information.
• Add a project by modifying the projects.yaml and submitting a pull request with your addition. This can also be done directly via the Github UI.

Before opening an issue or pull request, please ensure that you adhere to the following guidelines:

• Please make sure that the project was not already added or suggested to this best-of list. You can ensure this by searching the projects.yaml, the Readme, and the issue list.
• Add the project to the projects.yaml and never to the README.md file directly. Use the yaml format and the properties documented in the project properties section below to add a new project, for example:

  - name: Tensorflow
    github_id: tensorflow/tensorflow
    pypi_id: tensorflow
    conda_id: tensorflow
    labels: ["tensorflow"]
    category: ml-frameworks
  
• Please create an individual issue or pull request for each project.
• Please use the following title format for the issue or pull request: Add project: project-name.
• If a project doesn't fit into any of the pre-existing categories, it should go under the Others category by not assigning any category. You can also suggest a new category via the add or update category template on the issue page.

Update a project

If you like to suggest or contribute a project update, choose one of the following ways:

• Suggest a project update by opening an issue: Please use the update project template from the issue page and fill in the requested information.
• Update a project by modifying the projects.yaml and submitting a pull request with your changes. This can also be done directly via the Github UI.

Before opening an issue or pull request, please ensure that you adhere to the following guidelines:

• Only update the project in the projects.yaml and never to the README.md file directly. Use the yaml format and the properties documented in the project properties section below to update a new project.
• Please create an individual issue or pull request for each project.
• Please use the following title format for the issue or pull request: Update project: project-name.

Project properties

Please refer to the best-of-generator documentation for a complete and up-to-date list of supported project properties.

Improve metadata collection

If you like to contribute to or share suggestions regarding the project metadata collection, please refer to the best-of-generator repository.

Improve markdown generation

If you like to contribute to or share suggestions regarding the markdown generation, please refer to the best-of-generator repository.

Create your own best-of list

If you want to create your own best-of list, we strongly recommend to follow this guide. With this guide, it will only take about 3 minutes to get you started. It is already set-up to automatically run the best-of generator via our Github Action and includes other useful template files.

Code of Conduct

All members of the project community must abide by the Contributor Covenant, version 2.0. Only by respecting each other we can develop a productive, collaborative community. Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting a project maintainer.