Merge branch 'main' into Update_do-you-ensure-compliance-and-governan…

…ce-without-compromising-agility
SSWConsulting · Feb 9, 2024 · cf3b894 · cf3b894
2 parents afe4eaf + 482a314
commit cf3b894
Show file tree

Hide file tree

Showing 803 changed files with 7,788 additions and 3,569 deletions.
diff --git a/.github/workflows/pr-metrics.yml b/.github/workflows/pr-metrics.yml
@@ -22,7 +22,7 @@ jobs:
         with:
           fetch-depth: 0
 
-      - uses: microsoft/[email protected].3
+      - uses: microsoft/[email protected].10
         name: PR Metrics
         env:
           PR_METRICS_ACCESS_TOKEN: ${{ secrets.GITHUB_TOKEN }}

diff --git a/.github/workflows/validate-markdown.yml b/.github/workflows/validate-markdown.yml
@@ -81,7 +81,7 @@ jobs:
             FILE_ANCHOR=$(echo "$FILE_NAME" | sed 's/\./-/g')
             PR_COMMENT+="| [$FILE_PATH](https://github.com/$REPO_FULL_NAME/pull/$PR_NUMBER/files#$FILE_ANCHOR) | Line $LINE_NUM: $ERROR_DESC | [Rule $RULE_ID]($RULES_DOCS_URL#$RULE_ID) |\n"
           done < lint-results.txt
-          PR_COMMENT+="\nPlease review the errors and update your Markdown files accordingly.\n"
+          PR_COMMENT+="\nPlease review and update your Markdown files accordingly.\n"
           echo -e "$PR_COMMENT" > pr_comment.md
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

diff --git a/.markdownlint/config.json b/.markdownlint/config.json
@@ -6,12 +6,8 @@
     "MD004": {
         "style": "asterisk"
     },
-    "MD033": {
-        "allowed_elements": [
-            "details",
-            "summary"
-        ]
-    },
     "MD046": false,
-    "MD013": false
+    "MD013": false,
+    "MD033": false,
+    "MD036": false
 }
diff --git a/assets/fork.jpg b/assets/fork.jpg
diff --git a/assets/gitkraken.png b/assets/gitkraken.png
diff --git a/assets/sourcetree.png b/assets/sourcetree.png
diff --git a/categories/application-lifecycle-management-alm/rules-to-better-scrum.md b/categories/application-lifecycle-management-alm/rules-to-better-scrum.md
@@ -19,7 +19,7 @@ index:
   - create-pbis-under-2-days
   - definition-of-done
   - have-a-definition-of-ready
-  - estimating-do-you-break-large-tasks-into-smaller-tasks
+  - break-tasks
   - estimating-do-you-know-how-to-size-user-stories-effectively
   - do-you-estimate-business-value
   - technical-overview
@@ -33,7 +33,7 @@ index:
   - tasks-do-you-know-to-use-clear-task-descriptions
   - scrum-team-contract
   - tick-and-flick
-  - done-do-you-know-when-to-send-a-done-email-in-scrum
+  - when-to-send-a-done-email-in-scrum
   - done-do-you-know-when-to-do-a-test-please-in-scrum
   - done-do-you-know-how-to-make-sure-you-deliver-a-build-thats-tested-every-sprint
   - do-you-know-how-to-handle-undone-work
@@ -68,4 +68,6 @@ index:
   - acceptance-criteria
 ---
 
+Ready to revolutionize your project management? Check [SSW's Scrum and Agile Methodologies consulting page](https://www.ssw.com.au/consulting/scrum).
+
 Learn more about Scrum with [Azure DevOps](/rules-to-better-scrum-using-azure-devops) and [GitHub](/rules-to-better-scrum-using-github).
diff --git a/...e-management-alm/rules-to-better-version-control-with-tfs-aka-source-control.md b/...e-management-alm/rules-to-better-version-control-with-tfs-aka-source-control.md
@@ -41,6 +41,7 @@ index:
 - do-you-use-the-windows-explorer-integration
 - tfs-master-do-you-have-a-report-to-see-who-has-not-checked-in
 - check-in-before-lunch-and-dinner-do-you-work-in-small-chunks-check-in-after-completing-each-one
+- source-control-tools
 
 ---
 

diff --git a/categories/artificial-intelligence/index.md b/categories/artificial-intelligence/index.md
@@ -5,6 +5,6 @@ uri: artificial-intelligence
 index:
 - rules-to-better-chatgpt-prompt-engineering
 - rules-to-better-gpt
-- rules-to-better-ai-image-generators
+- rules-to-better-ai-generated-media
 
 ---
diff --git a/...ce/rules-to-better-ai-image-generators.md → ...nce/rules-to-better-ai-generated-media.md b/...ce/rules-to-better-ai-image-generators.md → ...nce/rules-to-better-ai-generated-media.md
@@ -1,10 +1,12 @@
 ---
 type: category
-title: Rules to Better AI Image Generators
+title: Rules to Better AI Generated Media
 guid: 692ea201-cdad-4505-bcb6-092e68793392
-uri: rules-to-better-ai-image-generators
+uri: rules-to-better-ai-generated-media
 experts:
 consulting:
+redirects: 
+ - rules-to-better-ai-image-generators
 index:
 - when-to-use-ai-generated-images
 - how-to-generate-an-ai-image
@@ -13,5 +15,5 @@ index:
 - use-negative-prompting
 - use-parameters-in-your-image-prompts
 - photoshop-generative-fill
-
+- ai-tools-voice-translations
 ---
diff --git a/categories/artificial-intelligence/rules-to-better-gpt.md b/categories/artificial-intelligence/rules-to-better-gpt.md
@@ -10,14 +10,18 @@ index:
 - what-is-gpt
 - chatgpt-vs-gpt
 - train-gpt
-- chatgpt-can-help-code
-- chatgpt-can-fix-errors
+- create-gpts
+- use-system-prompt
 - connect-chatgpt-with-virtual-assistant
 - install-chatgpt-as-an-app
-- indicate-ai-helped
-- leverage-chatgpt
-- website-chatbot
+- chatgpt-can-help-code
+- chatgpt-can-fix-errors
+- generate-ui-mockups-with-ai
 - use-semantic-kernel
 - use-embeddings
-- use-system-prompt
+- website-chatbot
+- indicate-ai-helped
+- leverage-chatgpt
 ---
+
+Want to revolutionize your business with GPT and ChatGPT integration? Check [SSW's GPT and ChatGPT consulting page](https://www.ssw.com.au/consulting/gpt).
diff --git a/categories/communication/rules-to-better-communication.md b/categories/communication/rules-to-better-communication.md
@@ -24,6 +24,8 @@ index:
 - take-effective-notes
 - escalate-key-updates
 - corridor-conversations
+- tofu
+- attention-to-detail
 
 ---
 

diff --git a/categories/communication/rules-to-better-email.md b/categories/communication/rules-to-better-email.md
@@ -6,7 +6,7 @@ uri: rules-to-better-email
 index:
 - dones-is-your-inbox-a-task-list-only
 - dones-do-you-use-email-for-tasks-only-not-communication
-- dones-do-you-reply-done-and-delete-the-original-email
+- reply-done-and-delete-the-email
 - send-to-myself-emails
 - as-per-our-conversation-emails
 - number-tasks-questions
@@ -77,6 +77,7 @@ index:
 - avoid-using-request-a-receipt
 - do-you-use-active-language-in-your-emails
 - avoid-sarcasm-misunderstanding
+- autocorrect-in-outlook
 - dictate-emails
 - screenshots-do-you-use-balloons-instead-of-a-wall-of-text
 - add-branding-to-screenshots

diff --git a/categories/communication/rules-to-better-inbox-management.md b/categories/communication/rules-to-better-inbox-management.md
@@ -7,7 +7,7 @@ index:
 - clean-your-inbox-per-topics
 - handle-noise-email
 - do-you-save-important-items-in-a-separate-folder
-- dones-do-you-reply-done-and-delete-the-original-email
+- reply-done-and-delete-the-email
 - how-to-hand-over-tasks-to-others
 - do-you-sort-your-emails-by-received-and-important
 - use-conditional-formatting-to-visually-deprioritize-emails

diff --git a/categories/communication/rules-to-better-microsoft-teams.md b/categories/communication/rules-to-better-microsoft-teams.md
@@ -38,8 +38,9 @@ index:
 - when-to-use-microsoft-teams-preview
 - teams-usage
 - use-microsoft-teams-room
+- use-text-formatting-to-mention-email-subjects
 ---
 
 Microsoft Teams offers a great solution to collaboration using the Office 365 platform. Get ready for a productivity boost, better focus on your work, and increased transparency.
 
-If you still need help, visit our [Microsoft Teams consulting page](https://www.ssw.com.au/ssw/Consulting/Microsoft-Teams.aspx) and book in a consultant.
+Need help with implementing Microsoft Teams? Check [SSW's Teams consulting page](https://www.ssw.com.au/consulting/microsoft-teams).
diff --git a/categories/communication/rules-to-better-outlook.md b/categories/communication/rules-to-better-outlook.md
@@ -6,6 +6,7 @@ uri: rules-to-better-outlook
 index:
 - searching-outlook-effectively
 - minimize-outlook-distractions
+- autocorrect-in-outlook
 - do-you-use-spelling-and-grammar-checker-to-make-your-email-professional
 - avoid-sending-emails-immediately
 - email-send-a-v2

diff --git a/categories/communication/rules-to-better-remote-work.md b/categories/communication/rules-to-better-remote-work.md
@@ -36,7 +36,9 @@ index:
 
 Working Remotely is something that is going to become more common. It is important that we have the tools to continue to **work from home** (aka **WFH**) effectively and efficiently whilst also maintaining good mental health.
 
-If you need help with your business, SSW can assist in putting the tools in place to allow your employees to continue working from home with little to no impact on their efficiency and productivity. Learn more on our [Remote Work consulting page](https://www.ssw.com.au/ssw/Consulting/Remote-Work.aspx).
+If you need help with your business, SSW can assist in putting the tools in place to allow your employees to continue working from home with little to no impact on their efficiency and productivity.
 
 `youtube: https://www.youtube.com/embed/pzDZ6Rw0Fls`
 **Figure**: Check out Jason's tips on Working From Home
+
+Need help with working remotely? Check [SSW's Remote Work consulting page](https://www.ssw.com.au/consulting/remote-work).
diff --git a/categories/communication/rules-to-better-technical-documentation.md b/categories/communication/rules-to-better-technical-documentation.md
@@ -8,6 +8,7 @@ index:
 - safety-step-when-deleting-content
 - do-you-avoid-duplicating-content
 - avoid-using-unnecessary-words
+- use-bad-and-good-examples
 - avoid-repetition
 - screenshots-tools
 - screenshots-do-you-use-balloons-instead-of-a-wall-of-text
@@ -29,7 +30,7 @@ index:
 - avoid-common-mistakes
 - avoid-acronyms
 - use-will-not-should
-- when-to-use-log-on-log-in-and-sign-in
+- user-authentication-terms
 - use-try-again-instead-of-retry
 - spell-aka-correctly
 - commas-and-full-stops-always-should-have-1-space-after-them

diff --git a/categories/design-and-presentation/index.md b/categories/design-and-presentation/index.md
@@ -5,6 +5,8 @@ uri: design-and-presentation
 index:
 - rules-to-better-designers
 - rules-to-better-content-design
+- rules-to-better-figma
+- rules-to-better-accessibility
 - rules-to-better-interfaces-general-usability-practices
 - rules-to-better-interfaces-forms
 - rules-to-better-interfaces-popups-and-messages
@@ -14,5 +16,6 @@ index:
 - rules-to-better-interfaces-mobile
 - rules-to-better-interfaces-winforms-controls
 - rules-to-better-logos
+
 ---
 
diff --git a/categories/design-and-presentation/rules-to-better-accessibility.md b/categories/design-and-presentation/rules-to-better-accessibility.md
@@ -0,0 +1,9 @@
+---
+type: category
+title: Rules to Better Accessibility
+guid: 1b3612b6-dd5d-4006-8a00-99b5785b6b02
+uri: rules-to-better-accessibility
+index:
+- wcag-compliance
+- color-contrast
+---
diff --git a/categories/design-and-presentation/rules-to-better-content-design.md b/categories/design-and-presentation/rules-to-better-content-design.md
@@ -14,18 +14,19 @@ index:
 - hemmingway-editor
 - avoid-using-gendered-pronouns
 - how-to-capitalize-titles
-- oxford-comma
 - avoid-common-mistakes
 - avoid-acronyms
+- ampersand
+- oxford-comma
 - distinguish-keywords-from-content
 - avoid-repetition
 - avoid-full-stops-in-bullet-point-lists
 ---
 
 Content design helps create a frictionless user experience by presenting the right information in the right way and at the right time. This is an application of design thinking principles, improving the ways you structure and present user-oriented content. Effective content leads to better:
 
-- Clarity and comprehension
-- User experience, engagement, and satisfaction
-- Consistency
-- Conversion optimization
-- Accessibility
+* Clarity and comprehension
+* User experience, engagement, and satisfaction
+* Consistency
+* Conversion optimization
+* Accessibility
diff --git a/categories/design-and-presentation/rules-to-better-designers.md b/categories/design-and-presentation/rules-to-better-designers.md
@@ -14,4 +14,7 @@ index:
 - user-journey-mapping
 - show-version-numbers
 - photoshop-generative-fill
+- when-to-use-canva
 ---
+
+Longing for remarkable design impact? Check [SSW's User Interface & User Experience Design showcase and consulting page](https://www.ssw.com.au/consulting/ui-ux-design).
diff --git a/categories/design-and-presentation/rules-to-better-figma.md b/categories/design-and-presentation/rules-to-better-figma.md
@@ -0,0 +1,10 @@
+---
+type: category
+title: Rules to Better Figma
+guid: 230aa546-4e9c-4f6e-9272-afd41c543373
+uri: rules-to-better-figma
+index:
+- software-for-ux-design
+- figma-prototypes
+
+---
diff --git a/categories/design-and-presentation/rules-to-better-interfaces-forms.md b/categories/design-and-presentation/rules-to-better-interfaces-forms.md
@@ -20,6 +20,7 @@ index:
 - do-you-create-a-popup-form-for-editing-details
 - do-you-follow-the-control-size-and-spacing-standards
 - do-you-group-related-fields-by-using-fieldset
+- use-html-maxlength-to-limit-number-of-characters
 - do-you-have-a-label-tag-for-the-fields-associated-with-your-input
 - do-you-have-consistent-way-to-store-a-same-field
 - label-buttons-consistently
@@ -35,4 +36,3 @@ index:
 ---
 
 For specific Windows Forms Application rules, go to [Rules to Better Windows Forms Applications](/rules-to-better-windows-forms).
-
diff --git a/categories/design-and-presentation/rules-to-better-interfaces-mobile.md b/categories/design-and-presentation/rules-to-better-interfaces-mobile.md
@@ -5,7 +5,7 @@ guid: 073cbcd8-c942-4a96-a54d-4682c4fc885e
 uri: rules-to-better-interfaces-mobile
 index:
 - do-you-design-for-touch-interfaces
-- do-you-know-to-hyperlink-your-phone-numbers
+- hyperlink-phone-numbers
 - do-you-know-what-guidelines-to-follow-for-wp
 - do-you-know-when-to-build-a-wp-app-over-an-iphone-app
 - do-you-know-when-to-build-an-iphone-app-over-an-iphone-web-app

diff --git a/categories/infrastructure-and-networking/rules-to-better-active-directory.md b/categories/infrastructure-and-networking/rules-to-better-active-directory.md
@@ -14,11 +14,12 @@ index:
 - do-you-use-separate-administrator-account
 - run-services-on-their-own-ad-accounts
 - check-ad-security-with-pingcastle
-- disable-leaving-employee-accounts
+- leaving-employee-standard
 - delete-computer-accounts-from-ad
 - audit-ad
 - domain-controller-auditing
 - laps-local-admin-passwords
+- run-rsat-from-non-domain-computer
 
 ---
 
diff --git a/categories/infrastructure-and-networking/rules-to-better-backups.md b/categories/infrastructure-and-networking/rules-to-better-backups.md
@@ -9,12 +9,12 @@ index:
 - disaster-recovery-plan
 - servers-do-you-use-the-best-backup-solution
 - pc-do-you-use-the-best-backup-solution
+- email-do-you-use-the-best-backup-solution
 - pc-do-you-organize-your-hard-disk
 - know-the-right-notification-for-backups
 - structure-and-back-up-your-files
 - have-your-files-available-offline
 
 ---
 
-If you still need help, [visit our Backup consulting page](https&#58;//www.ssw.com.au/ssw/Consulting/Backup-Recovery.aspx) and book in a consultant.
-
+Need help with Backup and Disaster Recovery Plan? Check [SSW's Backups consulting page](https://www.ssw.com.au/consulting/backup-recovery).
diff --git a/...es/infrastructure-and-networking/rules-to-better-data-protection-manager-dpm.md b/...es/infrastructure-and-networking/rules-to-better-data-protection-manager-dpm.md
@@ -9,5 +9,5 @@ index:
 - do-you-setup-sharepoint-backups-in-the-correct-order
 
 ---
-If you still need help, [visit our DPM consulting page](https&#58;//www.ssw.com.au/ssw/Consulting/Data-Protection-Manager.aspx) and book in a consultant.
 
+Need help with implementing Data Protection Manager? Check [SSW's DPM consulting page](https://www.ssw.com.au/consulting/data-protection-manager).
diff --git a/categories/infrastructure-and-networking/rules-to-better-hyper-v.md b/categories/infrastructure-and-networking/rules-to-better-hyper-v.md
@@ -25,4 +25,4 @@ index:
 
 ---
 
-If you still need help, [visit our Hyper-V consulting page](https&#58;//www.ssw.com.au/ssw/Consulting/Hyper-V.aspx) and book in a consultant.
+Need help with implementing a Virtualized Server Infrastructure? Check [SSW's Hyper-V consulting page](https://www.ssw.com.au/consulting/hyper-v).
diff --git a/categories/infrastructure-and-networking/rules-to-better-office-365.md b/categories/infrastructure-and-networking/rules-to-better-office-365.md
@@ -12,5 +12,5 @@ index:
 - groups-in-microsoft-365
 
 ---
-If you still need help, [visit our Office 365 consulting page](https&#58;//www.ssw.com.au/ssw/Consulting/Office-365.aspx) and book in a consultant.
 
+Want to work smarter with Microsoft 365? Check [SSW's Microsoft 365 consulting page](https://www.ssw.com.au/consulting/microsoft-365).
diff --git a/categories/infrastructure-and-networking/rules-to-better-security.md b/categories/infrastructure-and-networking/rules-to-better-security.md
@@ -11,6 +11,7 @@ index:
 - conditional-access-policies
 - microsoft-defender-365
 - do-you-use-access-packages
+- use-scim-for-identity-management
 - implementing-intune
 - open-policy-personal-data-breaches
 - do-you-use-built-in-authentication-from-ms
@@ -29,4 +30,6 @@ index:
 - migrate-an-existing-user-store-to-an-externalauthprovider
 ---
 
+Want to avoid embarrassing or expensive data breaches? Check [SSW's Security consulting page](https://www.ssw.com.au/consulting/security).
+
 Watch [the best security videos on SSW TV](https://tv.ssw.com/category/security) for free.
diff --git a/...ories/infrastructure-and-networking/rules-to-better-sharepoint-for-end-users.md b/...ories/infrastructure-and-networking/rules-to-better-sharepoint-for-end-users.md
@@ -18,4 +18,4 @@ index:
 
 ---
 
-If you still need help, visit our [SharePoint Consulting page](https://www.ssw.com.au/ssw/Consulting/SharePoint.aspx) and book in a consultant.
+Want to get your organization using SharePoint to collaborate? Check [SSW's SharePoint consulting page](https://ssw.com.au/consulting/sharepoint).
diff --git a/categories/infrastructure-and-networking/rules-to-better-system-administrators.md b/categories/infrastructure-and-networking/rules-to-better-system-administrators.md
@@ -34,6 +34,7 @@ index:
 - call-your-system-administrators-before-raising-a-ticket
 - ups-send-email
 - entra-group-access-reviews
+- run-rsat-from-non-domain-computer
 ---
 
 System Administrators (SysAdmins) are the lifeblood of any business. They mantain the infrastructure, networks and systems and cloud of businesses. This is why we have developed these standards for better System Administrators.

diff --git a/categories/management/rules-to-better-accounting.md b/categories/management/rules-to-better-accounting.md
@@ -9,11 +9,13 @@ index:
 - do-you-have-monthly-accounting-meetings
 - report-gas-in-the-tank
 - do-you-know-how-to-claim-expense-reimbursements
+- tax-invoice-vs-eftpos-receipt
 - do-you-use-the-best-mobile-app-for-expenses
 - claim-expense-reimbursements-with-xero
 - apple-google-pay-for-expenses
 - do-you-use-auto-fetch-functions-for-invoices
 - do-you-track-your-recurring-expenses
+- allocate-expenses-per-office
 - do-your-cheque-and-memo-fields-have-a-good-description
 - do-you-know-how-to-enter-a-hubdoc-receipt
 - how-do-you-manage-your-corporate-card
@@ -23,6 +25,9 @@ index:
 - pay-invoices-completely
 - how-to-enter-an-expensify-receipt
 - do-you-use-a-mobile-app-to-check-your-personal-payroll
+- salary-sacrifice-electronic-devices
+- salary-sacrifice-novated-lease
+- salary-terminology
 - do-you-calculate-payroll-tax-correctly
 - do-you-check-your-customers-organisation-age-for-prepaid
 - do-you-treat-freebies-as-real-customers