From ae1d1e648b4a201a2aba26287acf8aa02f6d22d3 Mon Sep 17 00:00:00 2001 From: nodiscc Date: Thu, 18 Jan 2024 19:22:56 +0000 Subject: [PATCH] doc: contributing: add an 'other guidelines' section for soft guidelines (#500) * doc: contributing: add an 'other guidelines' section for soft guidelines - these guidelines are only relevant for a small fraction of additions but would significantly increase the number of requirements in the pull request template, so add them in a separate document - move the guideline about providing a list of differences for forks to this document - ref. https://github.com/awesome-selfhosted/awesome-selfhosted-data/issues/33#issuecomment-1886405382 --------- Co-authored-by: Rabenherz112 --- .github/PULL_REQUEST_TEMPLATE.md | 1 - CONTRIBUTING.md | 14 +++++++++++++- 2 files changed, 13 insertions(+), 2 deletions(-) diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 0eaf94d097..0e70c70bc7 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -14,5 +14,4 @@ To ensure your Pull Request is dealt with swiftly, please check the following (c - [ ] Any software project you are adding to the list is actively maintained. - [ ] Any software project you are adding was first released more than 4 months ago. - [ ] Any software project you are adding has working installation instructions. -- [ ] If you are adding software forked from another active project, please provide/link to a clear list of differences between both. - [ ] You understand that your Pull Request will be merged ~1 week after approval, to allow for further comments if needed. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 22bbe1321d..3468daa956 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -84,7 +84,19 @@ To do this from Github's web interface: You can help cover domain name registration and renewal costs by pledging a small amount on [Liberapay ![](https://img.shields.io/liberapay/goal/awesome-selfhosted?logo=liberapay) ![](https://img.shields.io/liberapay/receives/awesome-selfhosted?logo=liberapay)](https://liberapay.com/awesome-selfhosted/) -### Other +### Other guidelines + +In addition to guidelines listed in the [Pull Request template](.github/PULL_REQUEST_TEMPLATE.md), these general rules help keep the list consistent: +- Please avoid redundant terms in project descriptions, such as _open-source_, _free_, _self-hosted_... as their presence on awesome-selfhosted already implies this. +- Prefer shorter forms for descriptions - for example, `Minimalist text adventure game` would be preferred to `A minimalist text adventure game` or `$PROJECT is a minimalist text adventure game`). +- If the the project has no documentation in English, please add `(documentation in $LANGUAGE)` at the end of the description. +- If the project is presented as an alternative to another service or application, please mention it as `(alternative to $PRODUCT1, $PRODUCT2)` at the end of the description. +- If you are adding software forked from another active project, please provide/link to a clear list of differences between both. +- If the project is forked from another project, please add `(fork of $PROJECT)` at the end of the description. +- If the project distributes a single static binary, please add the programming language in which it is written. + + +### Other operations **Rename a tag/category:** the tag must be renamed in the appropriate `tags/mytag.yml` file. All references to it must be updated in `tags/*.yml` and `software/*.yml`.