Merge branch 'main' into brainstorm-refined-topics

.github/workflows/TriggerDevOpsBuild.yml

@@ -17,4 +17,4 @@ jobs:
       run: |
         export AZURE_DEVOPS_EXT_PAT=${{ secrets.AZURE_DEVOPS_TOKEN }}
         chmod +x .workflow/build-production.sh
-        bash ./.workflow/build-production.sh
+        bash ./.workflow/build-production.sh ${{ github.token }}

.markdownlint/config.json

@@ -9,5 +9,7 @@
     "MD046": false,
     "MD013": false,
     "MD033": false,
-    "MD036": false
+    "MD036": false,
+    "MD055": false,
+    "MD024": false
 }

.workflow/build-production.sh

@@ -1,33 +1,83 @@
 #! /bin/bash
+#
+# CMD:
+#   $1. GitHub access token 
+
 github_org_name=sswconsulting
 github_repo_name=SSW.Rules
 azdo_org_name=https://ssw.visualstudio.com
 azdo_project_name=ssw.rules
 azdo_pipeline_name=Production
 azdo_history_pipeline_name=UpdateRulesHistory
+github_access_token=$1
 
 # exit when any command fails
 set -e
 
 # ensure devops extension is available
 az extension add -n azure-devops
 
-# get latest release branch from other repo
-echo Querying GitHub...
-branch_list=$(curl -s -X GET https://api.github.com/repos/${github_org_name}/${github_repo_name}/branches) 
+echo "Querying GitHub..."
+
+# Get release/x branch with the latest commit.
+res=$(curl -X POST \
+  https://api.github.com/graphql \
+  -H "Authorization: Bearer ${github_access_token}" \
+  -H "Content-Type: application/json" \
+  -d @- <<EOF
 {
-  branch_name=$(jq -r  '[.[].name | select(startswith("release/"))] | sort_by(.[8:]|tonumber) | reverse | .[0]' <<< "${branch_list}") 
-} || {
-  echo "GitHub response: ${branch_list}"
-  echo "::error Could not get latest release branch from GitHub"
-  exit 1
+  "query": "{
+    repository(owner: \"${github_org_name}\", name: \"${github_repo_name}\") {
+      refs(
+        refPrefix: \"refs/heads/release/\"
+        first: 1
+        orderBy: {field: TAG_COMMIT_DATE, direction: DESC}
+      ) {
+        edges {
+          node {
+            name
+            target {
+              ... on Commit {
+                committedDate
+              }
+            }
+          }
+        }
+      }
+    }
+  }"
 }
-echo Latest release branch: ${branch_name}
+EOF
+)
+
+# Check for cURL errors.
+if [ $? -ne 0 ]; then
+  echo "::error cURL request failed. Check your internet connection or GitHub API status."
+  exit 1
+fi
+
+# Check if the response contains an error message.
+if [ "$(jq -r '.errors' <<< "$res")" != "null" ]; then
+  echo "GitHub API error: $(jq -r '.errors[0].message' <<< "$res")"
+  echo "Documentation URL: $(jq -r '.errors[0].documentation_url' <<< "$res")"
+  exit 1
+fi
+
+latest_release=$(jq -r '.data.repository.refs.edges[0].node.name' <<< "${res}")
+latest_branch="release/${latest_release}"
+
+# Check if latest_release is null.
+if [ "$latest_release" = "null" ]; then
+  echo "::error Latest branch is null. No matching release branches found."
+  exit 1
+fi
+
+echo "Latest release branch: ${latest_branch}"
 
 echo triggering AzDO update history
 az pipelines build queue --org $azdo_org_name --project $azdo_project_name --definition-name $azdo_history_pipeline_name --branch main
 
 echo triggering AzDO build
-az pipelines build queue --org $azdo_org_name --project $azdo_project_name --definition-name $azdo_pipeline_name --branch $branch_name
+az pipelines build queue --org $azdo_org_name --project $azdo_project_name --definition-name $azdo_pipeline_name --branch $latest_branch
 
 echo done

categories/client-engagement/rules-to-better-software-consultants-working-in-a-team.md

@@ -24,7 +24,7 @@ index:
 - understand-the-power-of-empathy
 - go-the-extra-mile
 - browser-remove-clutter
-- is-everyone-in-your-team-a-standards-watchdog
+- standards-watchdog
 - what-is-mentoring
 - mentoring-programs
 - do-you-ask-questions-where-youre-stuck

categories/communication/rules-to-better-communication.md

@@ -5,7 +5,7 @@ guid: 471816bf-f0df-4835-bf4d-66a90f6f1adc
 uri: rules-to-better-communication
 index:
   - follow-up-effectively
-  - do-you-know-the-best-tool-for-facilitating-real-time-colloboration
+  - tool-for-facilitating-real-time-collaboration
   - catering-to-audience
   - zooming-in-and-out
   - ask-for-help

categories/company-operations/rules-to-better-recruiting.md

@@ -5,7 +5,7 @@ guid: 460e0413-a029-426b-b5e3-0ac68d7031f2
 uri: rules-to-better-recruiting
 index:
 - when-to-hire-more-people
-- rules-to-better-recruitment
+- find-excellent-candidates
 - do-you-use-linkedin-recruiter-to-help-you-find-more-candidates
 - do-you-use-an-ats
 - the-best-applicant-tracking-system
@@ -17,6 +17,7 @@ index:
 - prepare-a-special-goodbye-to-a-co-worker-leaving-the-company
 - do-you-thoroughly-test-employment-candidates
 - make-secondary-linkedin-account-obvious
+- successful-reachouts
 
 ---
 

categories/company-operations/rules-to-successful-projects.md

@@ -37,7 +37,7 @@ index:
 - do-you-know-the-best-way-to-give-the-best-customer-support
 - do-you-stop-dealing-with-data-and-schema
 - do-you-have-separate-development-testing-and-production-environments
-- is-everyone-in-your-team-a-standards-watchdog
+- standards-watchdog
 - when-you-follow-a-rule-do-you-know-to-refer-to-it-including-the-icon
 - do-you-thoroughly-test-employment-candidates
 - do-you-have-a-healthy-team

categories/design/rules-to-better-figma.md

@@ -6,5 +6,6 @@ uri: rules-to-better-figma
 index:
 - software-for-ux-design
 - figma-prototypes
+- figma-uses
 
 ---

categories/design/rules-to-better-websites-layout-and-formatting.md

@@ -1,6 +1,6 @@
 ---
 type: category
-title: Rules to Better Websites - Layout And Formatting
+title: Rules to Better Websites - Layout and Formatting
 guid: a4ffafbb-7fc8-4395-a35e-cb6c66ee6ec3
 uri: rules-to-better-websites-layout-and-formatting
 index:
@@ -11,6 +11,7 @@ index:
 - figures-do-you-use-images-to-reduce-the-words
 - add-useful-and-concise-figure-captions
 - use-bad-and-good-examples
+- avoid-unnecessary-css-classes
 - use-the-right-html-figure-caption
 - do-you-always-acknowledge-your-work
 - printing-do-you-have-a-print-css-file-so-your-web-pages-are-nicely-printable
@@ -50,7 +51,6 @@ index:
 - do-you-use-list-tags-for-lists-only
 - do-you-use-gravatar-for-your-profile-pictures
 - do-you-use-hyperlinks-instead-of-javascript-to-open-pages
-- use-dashes-between-words-in-urls
 - videos-do-you-have-a-video-on-the-homepage-of-products-websites
 - right-format-to-write-videos-time-length
 - do-you-use-presentation-templates-for-your-web-site-layouts

categories/project-delivery/rules-to-better-scrum.md

@@ -9,7 +9,7 @@ index:
   - scrum-master-do-you-schedule-the-3-meetings
   - do-you-know-what-happens-at-a-sprint-review-meeting
   - do-you-know-what-happens-at-a-sprint-retrospective-meeting
-  - do-you-know-what-happens-at-a-sprint-planning-meeting
+  - what-happens-at-a-sprint-planning-meeting
   - methodology-daily-scrums
   - the-3-commitments-in-scrum
   - do-you-know-the-how-to-be-a-good-product-owner

rules/8-steps-to-scrum/rule.md

@@ -45,7 +45,7 @@ This is also when the Product Owner 1st defines the Product Goal (aka the "why"
 
 A quick note, there are only 3 roles in a Scrum Team, The Product Owner (the boss), the Scrum Master (a kind of project manager), and the Developers (who do the work).
 
-### 3. [Sprint Planning](/do-you-know-what-happens-at-a-sprint-planning-meeting)
+### 3. [Sprint Planning](/what-happens-at-a-sprint-planning-meeting)
 
 The Sprint Planning session is for the Developers to focus on the subset of the Product Backlog that they think they can complete in the next Sprint, (which is most commonly a 2-week time-box).
 

rules/agreements-do-you-book-the-next-sprint-ahead-of-time/rule.md

@@ -13,9 +13,9 @@ redirects: []
 
 ---
 
-Unless we're currently working on the last Sprint of the development, you should always book the next Sprint as soon as you start work on the current one. 
+Unless we're currently working on the last Sprint of the development, you should always book the next Sprint as soon as you start work on the current one.
 <!--endintro-->
 
-This is done during the [Planning meeting](/do-you-know-what-happens-at-a-sprint-planning-meeting) and will ensure the availability of the developers who are up to speed on your project and stop them from being booked onto something else.
+This is done during the [Planning meeting](/what-happens-at-a-sprint-planning-meeting) and will ensure the availability of the developers who are up to speed on your project and stop them from being booked onto something else.
 
 ![Figure: If you have booked the guys in, you will have an appointment like this in your Outlook](Scheduled_Appointment.jpg)

rules/as-per-our-conversation-emails/rule.md

@@ -18,6 +18,7 @@ related:
   - conduct-a-test-please
   - do-you-seek-clarification-via-the-telephone-first
   - warn-then-call
+  - do-you-prepare-then-confirm-conversations-decisions
 redirects:
   - do-you-send-＂as-per-our-conversation＂-emails
   - do-you-send-as-per-our-conversation-emails

rules/avoid-unnecessary-css-classes/rule.md

@@ -18,7 +18,7 @@ It can be tempting to add classes on elements, as it is often the most obvious s
 
 <!--endintro-->
 
-You should use a front-end framework, like Bootstrap or Tailwind. The best front-end frameworks will include most of the clases you will need on a project. Basically you will only need new classes for very specific layout elements.
+You should use a front-end framework, like [Bootstrap](https://getbootstrap.com/) or [Tailwind](https://tailwindcss.com/). The best front-end frameworks will include most of the clases you will need on a project. Basically you will only need new classes for very specific layout elements.
 
 HTML:
 

rules/book-developers-for-a-project/rule.md

@@ -103,6 +103,20 @@ To book someone for internal work:
 
 ![Figure: Internally 'Booked' days show as black and 'Pencilled In' days show as grey](2020-03-20_10-49-19.png)
 
+### Deleting Bookings
+
+Cancelling an appointment in Outlook will not delete the appointment from Dynamics 365. Instead, you need to follow these steps:
+1. In the appointment, open the Dynamics 365 App
+2. Click on the menu next to **Tracked regarding**
+3. Click **Untrack**, then **Delete**
+4. Wait about a minute for Dynamics 365 to sync, then cancel the appointment
+
+![Figure: Outlook | Dynamics 365 App | Click Untrack and then Delete](dynamics-untrack.png)
+
+::: info
+You can't untrack a single occurrence of a series of appointments - instead, you need to cancel the occurrence and delete the appointment from Dynamics 365 manually.
+:::
+
 ### Using a separate Outlook calendar to book appointments
 
 If you have a lot of staff, it can be useful to use a separate calendar to make your bookings - this stops them from covering your everyday calendar and making it hard to read.
@@ -113,11 +127,12 @@ Using the example of SSW's **crmtimeprosync@** account, this account is used to
 
 ![Figure: Appointments tracked from with Outlook desktop](Appointments tracked from Outlook desktop.png)
 
-**Note:** If using a separate Exchange calendar, it's highly recommended to login via Outlook Web Access (OWA) rather than loading it up as a shared calendar in your Outlook Desktop client. This is because it handles multiple users much better this way, and will avoid synching issues. 
+**Note:** If using a separate Exchange calendar, it's highly recommended to login via Outlook Web Access (OWA) rather than loading it up as a shared calendar in your Outlook Desktop client. This is because it handles multiple users much better this way, and will avoid syncing issues. 
 
 ### How to set it up
 
-**For OWA** 
+**For OWA**  
+
 Open browser’s incognito mode | go to https://outlook.office.com | logon with the **crmtimeprosync@** account
 
 **For Outlook Desktop** 
@@ -126,4 +141,4 @@ Go to Files | Add an account | Restart Outlook once it completes
 
 ![Figure: Add account to your Outlook](Add account.jpg)
 
-Please note you will need to get the password from your friendly SysAdmins.
+Please note you will need to get the password from your enterprise password manager.

rules/call-first-before-emailing/rule.md

@@ -8,6 +8,7 @@ authors:
 related: 
   - as-per-our-conversation-emails
   - warn-then-try-calling-them
+  - do-you-prepare-then-confirm-conversations-decisions
 redirects:
   - do-you-always-call-first-before-emailing
 created: 2014-12-19T06:39:33.000Z

rules/close-off-thread/rule.md

@@ -5,27 +5,25 @@ uri: close-off-thread
 authors:
   - title: Adam Cogan
     url: https://www.ssw.com.au/people/adam-cogan
-created: 2023-09-18T20:52:37.996Z
-guid: dc9b3dc3-e7a4-4303-ad58-db8ee29936da
 related:
   - dones-do-you-reply-done-and-delete-the-original-email
+created: 2023-09-18T20:52:37.996Z
+guid: dc9b3dc3-e7a4-4303-ad58-db8ee29936da
 ---
-When a task gets finished via email, you should close off the related instant messaging (IM) thread by adding a "Done - see email".
+When handling email threads within instant messaging (IM), adding a **"Done - see email"** a clear and concise way to close off a thread.
 
 <!--endintro-->
 
-### Why reply "Done - see email"?
+### Benefits of using this method
 
-* **Clarity** - It tells everybody in the chat that a task is completed. It's a concise signal that minimizes unnecessary back-and-forth.
-* **Reducing clutter** - Closing discussions declutters your IM threads, making it easier to manage conversations.
-* **Records** - It helps maintain a record of actions taken (although this is already done by the email).
+* **Clarity and efficiency** - "Done - see email" offers clarity by indicating that an email-related task has been completed. This concise signal minimizes unnecessary back-and-forth, allowing you to focus on more critical matters.
+* **Reducing IM clutter** - In busy work environments, IM platforms can become crowded. Closing email discussions with "Done - see email" declutters your IM threads, making it easier to manage conversations.
+* **Record Keeping** - This phrase helps maintain a record of actions taken. It serves as a timestamped reference point for future discussions, aiding in task recall.
 
-### Use when
+### Using "Done - see email" wisely
 
-* A task related to an email is complete
-* You have already sent a [Done email](/dones-do-you-reply-done-and-delete-the-original-email/)
-* You want to close the conversation or change topics
+* Employ it when a task related to an email is complete
+* Specify action details in the email if necessary
+* Summarize key points in complex email threads 
 
-::: ok
-![Figure: Okay Example - Replying Done to close off the thread is good - but could have been better by mentioning the email subject for others to find it easily](close-thread.jpg)
-:::
+Close off a thread by "Done - see email" in IM to streamline conversations, reduce overload, and maintain organized records, ultimately improving productivity.

rules/custom-instructions/rule.md

@@ -77,9 +77,9 @@ You also:
 :::
 
 ::: good
-Figure: Good example - Starter custom instruction. Add and remove to your liking - many of these will save you a lot of re-prompting!
+Figure: Good example - Start with these custom instructions. Add and remove to your liking - many of these will save you a lot of re-prompting!
 :::
 
 ::: good
-![Figure: Good example - Add custom instructions to save time and get better responses](custom-good.png)
+![Figure: Good example - Specific and detailed custom instructions](seth-custom-instructions-good.jpg)
 :::

rules/digesting-brainstorming/rule.md

@@ -18,8 +18,7 @@ archivedreason: null
 guid: ef1035b9-2f40-4cd6-8915-51a0e91354ce
 ---
 
-The Brainstorming day is a lot of fun, but its important all the outcomes are captured and acted on.
-Once you have everyone's thoughts on the ideas, they need to be digested into actionable items.
+The Brainstorming day is a lot of fun, but its important all the outcomes are captured and acted on. Once you have everyone's thoughts on the ideas, they need to be digested into actionable items.
 
 <!--endintro-->