style: use numbered lists (#34057)
* style: use numbered lists Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com> * Update docs/contribute/doc-style-guide.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Aramis Sennyey <159921952+aramissennyeydd@users.noreply.github.com> * fix prettier Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com> --------- Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com> Signed-off-by: Aramis Sennyey <159921952+aramissennyeydd@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
This commit is contained in:
@@ -228,6 +228,14 @@ helps downstream localization.
|
||||
- Use (`-`) for unordered lists.
|
||||
- Leave a blank line after each list.
|
||||
- Indent nested lists with two spaces.
|
||||
- Use a numbered list for a sequence of steps rather than prose with
|
||||
"First", "Then", and "Finally". Numbered lists are easier to scan, make
|
||||
the order explicit, and give readers a clear way to reference a specific
|
||||
step.
|
||||
|
||||
| Do | Don't |
|
||||
| :----------------------------------------------------------------- | :------------------------------------------------------------------------------ |
|
||||
| 1) Install the package. 2) Run the migration. 3) Start the server. | First, install the package. Then, run the migration. Finally, start the server. |
|
||||
|
||||
### Tables
|
||||
|
||||
|
||||
Reference in New Issue
Block a user