1
0
Fork 0
mirror of https://github.com/tldr-pages/tldr.git synced 2025-07-24 15:35:27 +02:00

style-guide.md: write rules for short/long options (#9527)

* Write rules for short/long options

* Apply suggestions from code review

* Update contributing-guides/style-guide.md

* Remove note about `common/`

* Reword note about GNU style options
This commit is contained in:
Emily Grace Seville 2022-12-08 16:27:26 +10:00 committed by GitHub
parent 44fc59e816
commit 92623218aa
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -104,6 +104,11 @@ Example:
```
- Pre-translated alias page templates can be found [here](https://github.com/tldr-pages/tldr/blob/main/contributing-guides/translation-templates/alias-pages.md).
## Option syntax
- Use GNU-style **long options** (like `--help` rather than `-h`) when they are cross-platform compatible (available on multiple platforms where a command is intended to work among `android`, `linux`, `osx`, `sunos`, `windows`).
- In other cases use short options (like `-h`).
## Token syntax
User-provided values should use the `{{token}}` syntax