1
0
Fork 0
mirror of https://github.com/tldr-pages/tldr.git synced 2025-07-29 16:15:33 +02:00

style-guide: add page naming instructions (#17299)

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
This commit is contained in:
Managor 2025-07-21 19:40:44 +03:00 committed by GitHub
parent 091f837f7f
commit 231dc560a9
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -117,6 +117,8 @@ most [tldr pages clients](https://github.com/tldr-pages/tldr/wiki/Clients) will
In this case, the information of the Windows version of `cd` (stored in `pages/windows/cd.md`) will be displayed by default to Windows users, and a generic/common version (stored in `pages/common/cd.md`)
will be displayed for Linux, macOS, and other platform users.
Try to match the page filename with the invoked command. Do not use the project name if possible. The goal is to be as transparent as possible to the user when they are curious of a command.
### Aliases
If a command can be called with alternative names (like `vim` can be called by `vi`), alias pages can be created to point the user to the original command name.