rg, style-guide: improve heading wording (#15949)

This commit is contained in:
Managor
2025-03-17 12:21:54 +02:00
committed by GitHub
parent 6a6fa655ff
commit 987a7065e2
2 changed files with 2 additions and 2 deletions
+1 -1
View File
@@ -319,7 +319,7 @@ When describing keycaps or a keyboard shortcut for a utility, use the same [keyp
- Avoid using the page title in the description (e.g. use `A sketching and painting program designed for digital artists` instead of `Krita is a sketching and painting program designed for digital artists`)
- If the program name differs from its executable name, it can be named at the start of the heading (e.g. `rg` and Ripgrep).
- Avoid mentioning that the program is used on the command-line (e.g. use `Ripgrep is a recursive line-oriented search tool` instead of `Ripgrep is a recursive line-oriented CLI search tool`).
- Avoid mentioning that the program is used on the command-line (e.g. use `Ripgrep, a recursive line-oriented search tool` instead of `Ripgrep, a recursive line-oriented CLI search tool`).
For example, when writing documentation for `cd`, a tool to check out and work on a specific directory in the Terminal or Command Prompt, **do not** write a lengthy description such as:
+1 -1
View File
@@ -1,6 +1,6 @@
# rg
> Ripgrep is a recursive line-oriented search tool.
> Ripgrep, a recursive line-oriented search tool.
> Aims to be a faster alternative to `grep`.
> More information: <https://github.com/BurntSushi/ripgrep>.