Files
definitive-opensource-mustb…/CONTRIBUTING.md
2025-02-27 15:31:40 -08:00

2.3 KiB

Contributing Guidelines

Please note that this project is released with a Contributor Code of Conduct. By participating in this project, you agree to abide by its terms.

Table of Contents

A Quick Note

The scale of what this project is attempting to accomplish is one that can only be done collectively. All contributions are highly valued. For submission guidelines on projects, please consult the submission guidelines

Important

When possible, please edit the file directly and start a pull request instead of raising an issue.

Conventions

To establish uniformity accross the project, please adhere to these conventions.

  • Use the project's official name, not the repository name. Repository names often use lowercase and place dashes in place of spaces. Fallback to Title Casing if capitalization is not clear.
  • Platform tags are listed in the following order: Desktop OS (Order: Windows, MacOS, Linux), Mobile (Order: Android, IOS), CLI, SelfHost, Web, Plugin
  • One space to the | left and right | for row elements
  • For projects with multiple repositories (EX: one for IOS, Windows, etc) link the organization. For API star retrieval use their most popular repository.
  • The description should be the repository description. If there are multiple repositories, no description, or an inadequate one, fall back to the organization or their official website, or their repo's README. Do not write your own description and only use text from official sources of the project.
  • We use Github Flavored Markdown (GFM)

Guidelines

  • Check the archive, the backlog, and duplicates
  • Make sure the category is fitting
  • The pull request and commit should have concise and descriptive titles
  • If a project is in the grey zone for submission guidelines, include why it should be included.

How To Contribute

How to create a pull request.

  • Fork the repo
  • Edit your changes in the README
  • Propose changes