Skip to content

Commit 06e9d60

Browse files
committed
update instructions
1 parent dc8d3f1 commit 06e9d60

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

.github/copilot-instructions.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ When writing documentation, follow these guidelines:
1111

1212
## Grammar
1313

14+
* Avoid "we"/"our" referring to documentation authors
1415
* Use present tense verbs (is, open) instead of past tense (was, opened). For example, "The method returns a value" instead of "The method will return a value."
1516
* Write factual statements and direct commands. Avoid hypotheticals.
1617
* Use active voice where the subject performs the action.
@@ -81,7 +82,8 @@ When writing documentation, follow these guidelines:
8182

8283
## Adding links
8384

84-
* Add links to related topics and resources where appropriate.
85+
* Add links to related topics and resources where appropriate.
86+
* Use relative links for files in this repo
8587
* 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.
8688
* Links to bookmarks within the same article should be relative and start with `#`.
8789
* Link descriptions should be descriptive and make sense on their own. Don't use "click here" or "this link" or "here".

0 commit comments

Comments
 (0)