Skip to content

Commit 67bfda3

Browse files
committed
updates
1 parent d2d9645 commit 67bfda3

File tree

1 file changed

+5
-10
lines changed

1 file changed

+5
-10
lines changed

.github/copilot-instructions.md

Lines changed: 5 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,11 @@
11
When writing documentation, follow these guidelines:
22

3-
# Documentation Writing Instructions
4-
5-
These are our documentation writing style guidelines.
6-
7-
## General Style tips
3+
## General style tips
84

95
* Get to the point fast. Be concise and clear.
106
* Talk like a person.
117
* Simpler is better.
12-
* Be brief. Give customers just enough information to make decisions confidently. Prune every excess word.
8+
* Be brief. Give customers just enough information to make decisions confidently. Prune excess words.
139
* Break up long sentences.
1410
* Follow the style of the [Microsoft Writing Style Guide](https://learn.microsoft.com/style-guide/welcome/). If there's a conflict between the following guidelines and the Microsoft Writing Style Guide, ask how to resolve it.
1511

@@ -20,7 +16,7 @@ These are our documentation writing style guidelines.
2016
* Use active voice where the subject performs the action.
2117
* Write in second person (you) to speak directly to readers.
2218
* Use gender-neutral language.
23-
* Avoid multiple -ing words that can create ambiguity.
19+
* Avoid multiple -ing words that could create ambiguity.
2420
* Keep prepositional phrases simple and clear.
2521
* Place modifiers close to what they modify.
2622
* Use a conversational tone with contractions.
@@ -35,7 +31,6 @@ These are our documentation writing style guidelines.
3531
* Always capitalize proper nouns.
3632
* Don’t capitalize the spelled-out form of an acronym unless it's a proper noun.
3733
* Use title-style capitalization for product and service names.
38-
* In programming languages, follow the traditional capitalization of keywords and other special terms.
3934
* Don't use all uppercase for emphasis.
4035

4136
## Numbers
@@ -84,13 +79,13 @@ These are our documentation writing style guidelines.
8479
* `[!CAUTION]` Negative potential consequences of an action.
8580
* `[!WARNING]` Dangerous certain consequences of an action.
8681

87-
## Links
82+
## Adding links
8883

8984
* Add links to related topics and resources where appropriate.
9085
* Links to other documentation articles should be relative, not absolute. Start relative links with `/docs/` and include the `.md` suffix. If you add a link to another page on learn.microsoft.com that's not in this repo, remove https://learn.microsoft.com/en-us from the link.
9186
* Links to bookmarks within the same article should be relative and start with `#`.
9287
* Link descriptions should be descriptive and make sense on their own. Don't use "click here" or "this link" or "here".
93-
* When you are going to refer to another file or an article on the web, use this format: "For more information, see [C++ language reference](../cpp/cpp-language-reference.md)." The exception to this is the See Also links at the end of an article. Those should be markdown links and contain the title of the article you link to as the descriptive portion of the link.
88+
* When you are going to refer to another file or an article on the web, use this format: "For more information, see [descriptive name of link](link path)." The exception to this is the See Also links at the end of an article. Those should be markdown links and contain the title of the article you link to as the descriptive portion of the link.
9489

9590
## Adding new files
9691

0 commit comments

Comments
 (0)