From c8545b853f55458919ab8800891cb35210f6907d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tiago=20Ara=C3=BAjo=20=5BSSW=5D?= Date: Thu, 28 Mar 2024 14:07:35 -0300 Subject: [PATCH 1/6] Made "include URL" rule generic... instead of just for "Dones" --- rules/dones-do-your-dones-include-a-url/rule.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) 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 c993103d1b3..e70178f6714 100644 --- a/rules/dones-do-your-dones-include-a-url/rule.md +++ b/rules/dones-do-your-dones-include-a-url/rule.md @@ -1,6 +1,6 @@ --- type: rule -title: Dones - Do your 'Dones' include a URL? +title: Do you include URLs to tasks and "Done" emails? uri: dones-do-your-dones-include-a-url authors: - title: Adam Cogan @@ -9,7 +9,9 @@ authors: url: https://ssw.com.au/people/cameron-shaw - title: Ulysses Maclaren url: https://ssw.com.au/people/ulysses-maclaren -related: [] +related: + - add-context-reasoning-to-emails + - dones-do-you-include-useful-details-in-your-done-email redirects: - dones-do-your-done’s-include-a-url created: 2009-12-10T06:55:30.000Z @@ -18,14 +20,14 @@ guid: ed0fa76a-418b-4b59-9e3b-2544c08b910e --- -Always include the relevant URL to your "Done" emails, like when you make a change to a webpage or document. This way people can check the work that was done. +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. +If you are using a task tracking system like **Azure DevOps**, **GitHub**, or Jira, also include the link to the PBI/Issue/task. ::: info -**Tip:** Sometimes it is [important to give context and reasoning](/do-you-add-context-reasoning-to-your-emails) to your 'Done' emails too. +**Tip:** It is [important to give context and reasoning](/do-you-add-context-reasoning-to-your-emails) to your emails too. ::: ::: greybox From 512ac90c358f392ce7f27fd21cfadec040bb89f5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tiago=20Ara=C3=BAjo=20=5BSSW=5D?= Date: Thu, 4 Apr 2024 19:10:35 -0300 Subject: [PATCH 2/6] Update rules/dones-do-your-dones-include-a-url/rule.md Co-authored-by: Jayden Alchin [SSW] <75593567+jaydenalchin@users.noreply.github.com> --- rules/dones-do-your-dones-include-a-url/rule.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 e70178f6714..c61e852497c 100644 --- a/rules/dones-do-your-dones-include-a-url/rule.md +++ b/rules/dones-do-your-dones-include-a-url/rule.md @@ -1,6 +1,6 @@ --- type: rule -title: Do you include URLs to tasks and "Done" emails? +title: Do you include URLs in tasks and "Done" emails? uri: dones-do-your-dones-include-a-url authors: - title: Adam Cogan From c14c6e39a950a23d5ab605ec238691a0a0e89562 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tiago=20Ara=C3=BAjo=20=5BSSW=5D?= Date: Thu, 4 Apr 2024 19:19:58 -0300 Subject: [PATCH 3/6] Update rule.md --- rules/dones-do-your-dones-include-a-url/rule.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) 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 c61e852497c..13c0fd74e19 100644 --- a/rules/dones-do-your-dones-include-a-url/rule.md +++ b/rules/dones-do-your-dones-include-a-url/rule.md @@ -1,7 +1,7 @@ --- type: rule title: Do you include URLs in tasks and "Done" emails? -uri: dones-do-your-dones-include-a-url +uri: include-links-in-emails authors: - title: Adam Cogan url: https://ssw.com.au/people/adam-cogan @@ -14,6 +14,7 @@ related: - dones-do-you-include-useful-details-in-your-done-email redirects: - dones-do-your-done’s-include-a-url + - dones-do-your-dones-include-a-url created: 2009-12-10T06:55:30.000Z archivedreason: null guid: ed0fa76a-418b-4b59-9e3b-2544c08b910e From 258b289a53a48c570a2283277762e2f69e7bb829 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tiago=20Ara=C3=BAjo=20=5BSSW=5D?= Date: Thu, 4 Apr 2024 19:20:23 -0300 Subject: [PATCH 4/6] Update rules-to-better-email.md --- categories/communication/rules-to-better-email.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/categories/communication/rules-to-better-email.md b/categories/communication/rules-to-better-email.md index 2150b67e3a7..42e60ed6158 100644 --- a/categories/communication/rules-to-better-email.md +++ b/categories/communication/rules-to-better-email.md @@ -28,7 +28,7 @@ index: - send-email-tasks-to-individuals - add-context-reasoning-to-emails - seek-clarification-via-phone -- dones-do-your-dones-include-a-url +- include-links-in-emails - dones-do-you-reply-done-using-team-companion-when-using-tfs - dones-do-you-include-useful-details-in-your-done-email - keep-email-history From b75aae301750399b76571b6415a368dcad5b4b85 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tiago=20Ara=C3=BAjo=20=5BSSW=5D?= Date: Thu, 4 Apr 2024 19:20:50 -0300 Subject: [PATCH 5/6] Update rule.md --- .../rule.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/rules/dones-do-you-include-useful-details-in-your-done-email/rule.md b/rules/dones-do-you-include-useful-details-in-your-done-email/rule.md index 306b02e8a87..da9d7501d93 100644 --- a/rules/dones-do-you-include-useful-details-in-your-done-email/rule.md +++ b/rules/dones-do-you-include-useful-details-in-your-done-email/rule.md @@ -23,7 +23,7 @@ guid: d5b7a283-6bad-4b12-a49d-9a88e30a552b --- An email with just the word "done" can often be enhanced with a screen capture or code snippet. Obviously this is also valid for tasks/requests. -In any email you send, **include relevant information**, such as [URLs](/dones-do-your-dones-include-a-url), screenshots, and pieces of code/text that will allow others to understand what was done or needs to be done straight away. +In any email you send, **include relevant information**, such as [URLs](/include-links-in-emails), screenshots, and pieces of code/text that will allow others to understand what was done or needs to be done straight away. From 9ae09b56ec2d52b85d1d75ac91c9a8d740ccf4c9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tiago=20Ara=C3=BAjo=20=5BSSW=5D?= Date: Thu, 4 Apr 2024 19:21:18 -0300 Subject: [PATCH 6/6] Update rule.md --- rules/add-context-reasoning-to-emails/rule.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/rules/add-context-reasoning-to-emails/rule.md b/rules/add-context-reasoning-to-emails/rule.md index 53ba248822c..3dfc786b512 100644 --- a/rules/add-context-reasoning-to-emails/rule.md +++ b/rules/add-context-reasoning-to-emails/rule.md @@ -23,7 +23,7 @@ Sometimes you send an email and get a response saying it's too cryptic. Never as -It starts with a [good email subject](/good-email-subject). Then provide extra clear information by [adding links](/dones-do-your-dones-include-a-url) and [screenshots with useful captions](/add-useful-and-concise-figure-captions) to emails. +It starts with a [good email subject](/good-email-subject). Then provide extra clear information by [adding links](/include-links-in-emails) and [screenshots with useful captions](/add-useful-and-concise-figure-captions) to emails. Also make sure to always [keep the history of an email](/keep-email-history), so there are enough details in the thread for anyone else to acknowledge what is going on.