style-guide: add grouping documentation (#15773)

Co-authored-by: Juri Dispan <juri.dispan@posteo.net>
This commit is contained in:
Managor
2025-03-01 22:28:36 +02:00
committed by GitHub
parent 0b8c0bd452
commit 59e238fb5b
+16
View File
@@ -226,6 +226,22 @@ In the following case `just.md` is the filename of the disambiguation page while
`tldr just.js`
```
### Grouping commands
Sometimes commands are meant to be used in combination with other commands. In these cases it makes sense to move them on the same page.
For example `adb disconnect` has a single way using it, but `adb` is expansive enough that it doesn't fit in the main page. Normally, `adb disconnect` is used in combination with `adb pair` and `adb connect`, thus it makes sense to group these together into a single page. For example:
```md
# adb disconnect
> This command has been moved to `adb connect`.
- View documentation for `adb disconnect`:
`tldr adb connect`
```
## General writing
### Emphasis