From 4d52aeda20989725dfda576222f1fb2ff27ea3a3 Mon Sep 17 00:00:00 2001 From: Managor <42655600+Managor@users.noreply.github.com> Date: Mon, 3 Mar 2025 18:40:02 +0200 Subject: [PATCH] style-guide: clarify placeholders (#15807) --- contributing-guides/style-guide.md | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/contributing-guides/style-guide.md b/contributing-guides/style-guide.md index 8ca22afe31..19a9a092ac 100644 --- a/contributing-guides/style-guide.md +++ b/contributing-guides/style-guide.md @@ -484,12 +484,7 @@ Keep the following guidelines in mind when choosing placeholders: - If a command can optionally take 1 or more arguments of the same kind, use an ellipsis: `{{placeholder1 placeholder2 ...}}`. For instance, if multiple paths are expected, use `{{path/to/directory1 path/to/directory2 ...}}`. -- If a command can optionally take 1 or more arguments of different kinds, use an ellipsis: `{{placeholder1|placeholder2|...}}`. - If there are more than 5 possible values, you can use `|...` after the last item. -- It's impossible to restrict the minimum or (and) maximum placeholder count via `ellipsis`. - -It's up to the program to decide how to handle duplicating values, provided syntax -tells no info about whether items are mutually exclusive or not. +- If only one of the multiple options is possible, write it as: `{{placeholder1|placeholder2|placeholder3}}`. If there are more than 4 possible values, you can use `|...` after the last item. #### Optional placeholders