- use lowercase for filenames whenever possible. No need to SHOUT!
- always use a proper file-extension. Not README, but readme.md.
- Avoid polluting the root of your project-directory with file that are not required to be in the root.
- Only keep files in the root if there are really required there.
- .yaml is the official file-extension for YAML-files.
- dashed lowercase, e.g. foo-bar
- ascii, avoid non-ascii unicode chars
- use lowercase, avoid capitals (git clone will create a similar named local directory)
- prefer dashes over underscores
- license.md:
- use license-file in the root of the project, as github will introspect this file to enhance the UI.
- github will not follow symlinks
- lowercase + use file-extension, e.g license.md
- the title in the license-file should contain the name of the license, e.g. MIT
- github will render a summarized view when viewing the license-file:
-
- use lowercase
- github will recognize a code-of-conduct in the docs/-directory.
-
- use lowercase
- github will recognize a readme in the docs/-directory.
-
- use lowercase
- github will recognize a readme in the docs/-directory.
-
- github will recognize a code-of-conduct in the docs/-directory.
-
- github is not very consistent with uppercasing/lowercasing required filenames
- CODEOWNERS must be uppercased
-
- the directory ISSUE_TEMPLATE must be uppcased
Community Standards for this project: