From 0239f5de94261ad86d2e31ac0c64de1a622afbc8 Mon Sep 17 00:00:00 2001 From: Emily Grace Seville Date: Fri, 6 Jan 2023 22:51:40 +1000 Subject: [PATCH] style-guide.md: refresh page (#9709) * Restrict alternatvie count to 5 * Enhance grammar --- contributing-guides/style-guide.md | 1 + 1 file changed, 1 insertion(+) diff --git a/contributing-guides/style-guide.md b/contributing-guides/style-guide.md index 2df0f4f182..1cc761267e 100644 --- a/contributing-guides/style-guide.md +++ b/contributing-guides/style-guide.md @@ -169,6 +169,7 @@ All borders of integer and float ranges get included. If you want to exclude the and use the `{{/dev/sdXY}}` placeholder for *block devices* instead of `/dev/sda1`. - If a command can take a variable number of arguments, use an ellipsis: `{{arg1 arg2 ...}}`. If one of the multiple options is possible, write it as `{{either|or}}`. + If there are more than 5 alternatives, use `|...` for the ellipsis. In general, placeholders should make it as intuitive as possible to figure out how to use the command and fill it in with values.