diff --git a/rules/dones-do-your-dones-include-a-url/rule.md b/rules/dones-do-your-dones-include-a-url/rule.md index 13c0fd74e19..0a997f2a78e 100644 --- a/rules/dones-do-your-dones-include-a-url/rule.md +++ b/rules/dones-do-your-dones-include-a-url/rule.md @@ -21,7 +21,7 @@ guid: ed0fa76a-418b-4b59-9e3b-2544c08b910e --- -Always include the relevant URL to your emails, like when you want to request or just made a change to a webpage or document. This way people can easily check the details of the tasks. This is especially important for ["Done" emails](reply-done-and-delete-the-email). +Always include the relevant URL to your emails, like when you want to request or just made a change to a webpage or document. This way people can easily check the details of the tasks. This is especially important for ["Done" emails](/reply-done-and-delete-the-email). If you are using a task tracking system like **Azure DevOps**, **GitHub**, or Jira, also include the link to the PBI/Issue/task. @@ -57,7 +57,7 @@ Figure: Good example - Easy to check what was done + includes the context of the Before declaring a task 'done' with a link, ensure that your changes are live and accessible for verification. -##### ❌ **Scenario:** PR waiting for approval +#### Scenario: ❌ PR waiting for approval ::: greybox Done - ssw.com.au/rules/dones-is-your-inbox-a-task-list-only @@ -83,7 +83,7 @@ Done - ssw.com.au/rules/dones-is-your-inbox-a-task-list-only Figure: OK example - Links are included, changes are not live yet, but people are aware ::: -##### ✅ **Scenario:** PR approved and merged +#### Scenario: ✅ PR approved and merged ::: greybox Done - ssw.com.au/rules/dones-is-your-inbox-a-task-list-only @@ -96,7 +96,7 @@ Figure: Good example - Final link is included and changes are live to be checked It is a common problem where someone CC'd will not have permissions to see a file and the sender knows this. You should still add the link but inform the recipient. -**Scenario:** Recipient doesn't have permissions. +#### Scenario: ❌ Recipient doesn't have permissions ::: greybox Done - onedrive.live.com/file-name.xls