Merge branch 'main' into ozair-do-you-know-the-best-practices-for-fro…

…ntmatter-in-markdown

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

@@ -5,6 +5,7 @@ guid: 8d4f1557-16a2-4e77-aee7-95c8d3c5123d
 uri: rules-to-better-microsoft-teams
 index:
 - create-a-team
+- connect-client-im
 - teams-naming-conventions
 - use-emojis
 - teams-group-chat

categories/management/rules-to-better-sales.md

@@ -17,6 +17,7 @@ index:
   - do-you-send-some-client-love-a-few-days-after-the-initial-meeting
   - do-you-incentivize-a-quick-spec-review-sale
   - follow-up-to-confirm-spec-review
+  - connect-client-im
   - do-you-schedule-a-followup-meeting-after-a-spec-review
   - do-you-explain-the-cone-of-uncertainty-to-people-on-the-fence-about-agile
   - do-you-enter-into-a-binding-written-contract-with-a-client-before-doing-any-billable-work

categories/marketing-and-video/rules-to-better-event-management.md

@@ -27,11 +27,12 @@ index:
 - evaluate-your-event-feedback
 - avoid-dates-text-in-graphics-for-events
 - do-you-use-events-to-market-your-consulting-work
+- presentation-run-sheet
 
 ---
-Organising an event is both rewarding and a lot of fun. There are a great number of things that you need to keep in mind though, when managing your event, whether it is a large conference, a user group or a once off launch of the latest product.
+Organizing an event is both rewarding and a lot of fun. There are a great number of things that you need to keep in mind though, when managing your event, whether it is a large conference, a user group or a once off launch of the latest product.
 
-The below rules offer guidelines to help you create a professional, efficient and successful event that can be replicated and become a stable of your professional community. The rules are based on experience from community events, such as user groups, hackdays and conferences like DDD Melbourne, however, the rules can also be applied to commercial and large scale events.
+The below rules offer guidelines to help you create a professional, efficient and successful event that can be replicated and become a stable of your professional community. The rules are based on experience from community events, such as user groups, hackdays and conferences like [DDD Melbourne](https://www.dddmelbourne.com/), however, the rules can also be applied to commercial and large scale events.
 
 The rules are split into three distinct sections:
 

categories/others/rules-to-better-brainstorming.md

@@ -14,4 +14,7 @@ index:
 
 ---
 
-SSW has been running brainstorming for many years. Every time we try improve the process to ensure the attendees and the company are getting the most out of the day.
+SSW has been running Brainstorming days for many years. Every time we improve process to ensure the attendees and the company are getting the most out of the day.
+
+![](brainstorming-day.png)
+**Figure: SSW Brainstorming 🤖**

categories/websites/rules-to-better-websites-navigation.md

@@ -32,7 +32,6 @@ index:
 - do-you-avoid-email-harvesting-or-spamming-by-using-images
 - do-you-avoid-linking-users-to-the-sign-in-page-directly
 - does-your-menu-use-an-icon-to-indicate-if-there-is-a-sub-menu
-- forgot-password-do-you-read-their-mind
 - login-security-do-you-know-the-correct-error-message-for-an-incorrect-user-name-or-password
 - do-you-avoid-letting-the-screen-go-white
 - do-you-give-option-to-widen-a-search

rules/brainstorming-agenda/rule.md

@@ -1,6 +1,6 @@
 ---
 type: rule
-title: Do you the Brainstorming day agenda?
+title: Do you know the Brainstorming day agenda?
 uri: brainstorming-agenda
 authors:
   - title: Adam Cogan
@@ -33,7 +33,7 @@ Ensure this is sent out to all staff months before the event to encourage ideas.
 
 ### Hi All,
 
-I’m really excited about our brainstorming day! I hope you’re all thinking about what you would like to work on.
+I’m really excited about our Brainstorming day! I hope you’re all thinking about what you would like to work on.
 
 To prepare for our Brainstorming day, send Adam, Matt W, William, Piers and Brady something that you would like work on as a group.
 E.g. Our awesome SophieBot project came out of the Melbourne Brainstorming Session last year.
@@ -53,4 +53,33 @@ See video on: [https://ssw.com.au/rules/use-the-brains-of-your-company](/use-the
 - **3:30 pm** - 🎤 Start presentations (Tip: Start presentations earlier/later depending on how many people are attending)
 - **6:00 pm** – 🍻 The pub!
 :::
-:::
+:::
+
+
+## Presentations
+
+The presentations are a very important part of the brainstorming as they are sharing the outcomes of the idea with the stakeholders who can decide whether the ideas should be implemented or not.
+
+To keep presentations consistent, use a template and ensure the following is covered:
+1. Pain - What is the problem you are solving?
+2. Potential solutions and a recommendation - How can we fix the problem?
+3. Cost - how long is it going to take and how much will it cost?
+4. Next steps - how can this solution be implemented?
+
+`youtube: https://youtu.be/C6XdZgxy2K8`
+**Figure: SSW's Brainstorming PowerPoint Template (6 min)**
+
+In order to get through all the presentation in 1 day, allocate a strict schedule.
+
+E.g.
+Presentation Delivery: 7 Minutes
+Audience Q&A: 3 Minutes
+Adam’s Feedback: 3 Minutes
+Changeover: The next group must be ready to go immediately!
+
+If the team has a demo to share, get them to pre-record it and embed it into the PowerPoint. This will save time and ensure the demo goes smoothly.
+
+### Run sheet
+To help presentations run smoother, its a good idea to set up a [presentation run sheet](/presentations-runsheet) and then share it with the attendees on the day.
+
+This could be in a GitHub Discussion, Microsoft Loop or Word Doc. 

rules/brainstorming-day-retro/rule.md

@@ -1,6 +1,6 @@
 ---
 type: rule
-title: Do you do a brainstorming day retro?
+title: Do you do a Brainstorming day retro?
 uri: brainstorming-day-retro
 authors:
   - title: Adam Cogan
@@ -18,15 +18,15 @@ archivedreason: null
 guid: 49948fd0-6eb7-4140-b82c-4a9268661fb6
 ---
 
-The results of the brainstorming day can have great impact on the company. Its important to get everyone thoughts on each idea.
+The results of the Brainstorming day can have great impact on the company. Its important to get everyone thoughts on each idea.
 
 Send out a Microsoft form with the following questions
 
 1. Did you watch the Brainstorming presentation (in person or live stream)?
 2. ✅ What went well?
 3. ❌ What went well?
 4. 💡 Any ideas to improve it?
-5. {{IDEA NAME}} - How good was the outcome of the brainstorming session?
+5. {{IDEA NAME}} - How good was the outcome of the Brainstorming session?
    - Rating /10
    - In the question, Include a link to the GitHub Discussion and YouTube video of the presentation
 6. {{IDEA NAME}} - Which option/s should we do?
@@ -35,4 +35,4 @@ Send out a Microsoft form with the following questions
 
 Repeat questions 5 and 6 for each idea.
 
-This should be done on the friday after the brainstorming day. 
+This should be done on the friday after the Brainstorming day. 

rules/brainstorming-idea-farming/rule.md

@@ -1,6 +1,6 @@
 ---
 type: rule
-title: Do you know how to farm brainstorming ideas?
+title: Do you know how to farm Brainstorming ideas?
 uri: brainstorming-idea-farming
 authors:
   - title: Adam Cogan
@@ -18,11 +18,11 @@ archivedreason: null
 guid: 3dcf22f6-5c13-46b4-88c7-b6edac5d6996
 ---
 
-Its important to have some pre-prepared ideas for the brainstorming day. This helps the day run smoother and can make it more valuable.
+Its important to have some pre-prepared ideas for the Brainstorming day. This helps the day run smoother and can make it more valuable.
 
-GitHub Discussions provides an awesome way to let employees discuss the ideas before the brainstorming day. GitHub Discussion template also make it easy for attendees to submit quality ideas in a consistent format.
+GitHub Discussions provides an awesome way to let employees discuss the ideas before the Brainstorming day. GitHub Discussion template also make it easy for attendees to submit quality ideas in a consistent format.
 
-1. First, look at ideas that have come through via email, and also any ideas from past brainstorming sessions
+1. First, look at ideas that have come through via email, and also any ideas from past Brainstorming sessions
 2. Come up with a few ideas for the day, these should come from high-level people in the company.
 3. If necessary, call the person who came up with the idea and ask for further explanation or for them to record a Done Video to sell their idea.
 4. Create GitHub Discussions for any noteworthy ideas, these discussions will serve as talking points for your company to iterate upon the idea.
@@ -37,9 +37,9 @@ Now that you have some initially curated ideas use Microsoft forms to gather, it
 
 - ✅ Retro - What is working well at {{ COMPANY NAME }}?
 - ❌ Retro - What are 1 (or more) things that you would improve at {{ COMPANY NAME }}?
-- 💡 Any brainstorming ideas for next week? (that is not listed above)
+- 💡 Any Brainstorming ideas? (that are not listed above)
   Create a GitHub Discussion {{LINK TO NEW GITHUB DISCUSSION TEMPLATE}}
 
-3. 2 weeks before the brainstorming session send out the form to the company.
-4. Go through all the ideas and pick the ones that are the most valuable
-5. Ensure all the GitHub Discussions have enough information to be able to be worked on.
+1. 2 weeks before the Brainstorming session send out the form to the company.
+2. Go through all the ideas and pick the ones that are the most valuable
+3. Ensure all the GitHub Discussions have enough information to be able to be worked on.

rules/brainstorming-team-allocation/rule.md

@@ -18,18 +18,16 @@ archivedreason: null
 guid: 1c77e04d-8351-415a-80e8-24983048f7f5
 ---
 
-Separating the group into teams on the brainstorming day can take a long time. It is better to do this before the day. Doing it early also allows you to keep team sizes consistent and share the teams with the group before the day.
+Separating the group into teams on the Brainstorming day can take a long time. It is better to do this before the day. Doing it early also allows you to keep team sizes consistent and share the teams with the group before the day.
 
-## Idea voting - Gather, iterate and gauge interest in ideas
+## Form - Vote on ideas
+Send out a Microsoft Form to the entire company to vote on which ideas they want to work on. It should have the following questions
+- Are you attending the Brainstorming day? (2 options - Yes/No)
+- For each idea (1 question per idea) - Do you want to work on {{IDEA NAME}}? {{LINK TO DISCUSSION}} (1 option - Yes) 
+- Indicate that people should pick 3 or more ideas
 
-4. 1 day before the brainstorming review the results of the form, curate the ideas, and create GitHub Discussions for any new and awesome ideas.
-5. Using the nicely curated ideas, create a 2nd Microsoft Form with the following questions:
+Having a separate question for each idea is important to get the data in a good format to allocate teams with minimal data transformation.
 
-- Ideas - Rank the importance of fixing these items
-
-  👨 = friendly for non-devs
-
-8. Send that form out to all employees to gauge interest and importance in the ideas.
 
 ## Team allocation
 
@@ -49,7 +47,6 @@ Upload the Excel file to ChatGPT and use this prompt
 I need this data in a format to allocate teams, I want each idea as a row then each person who voted for that idea as a column after it.
 :::
 
-
 1. To assign teams, start by assigning the most capable people to each team as a team lead - its not required but is helpful if this is the person who came up with the idea
 2. After each team has a team lead, assign the remaining people based on their preference, skillset and interests
 
@@ -61,17 +58,26 @@ I need this data in a format to allocate teams, I want each idea as a row then e
 1. Each team also needs to be assigned an Idea Product Owner person to test the presentation and give feedback.
 2. Once everyone is allocated a team, share the result with the group.
 
-## Team setup
+### Team setup
 
-In order to make the brainstorming day as productive as possible, set up the PowerPoints using a template.
+In order to make the Brainstorming day as productive as possible, set up the PowerPoints using a template.
 
 1. Create new Teams team for the Brainstorming day E.g. Sydney Brainstorming 2023
 2. For each team, create a folder in the Files tab
-3. Use a brainstorming PowerPoint template to create a PowerPoint for each team
-    - The template should have the structure of a good Brainstorming presentation (Show the pain, suggested solutions and proposed next steps)
-
+3. Use a Brainstorming PowerPoint template to create a PowerPoint for each team
 
 `youtube: https://youtu.be/C6XdZgxy2K8`
-**Figure: Brainstorming powerpoint template**
+**Figure: Brainstorming powerpoint template (6 min)**
+
+Having all the presentations in one location (Teams team) makes it easy to collaborate and ensures they wont be lost. It also means all the presentations can happen on a single device, instead of switching laptop every presentation which can be slow and lead to AV issues.
+
+## Share the teams with the company
+
+Once the teams have been allocated, create a new GitHub Discussion with all the ideas and the teams with a link to the original idea Discussion.
+Share the Discussion in an email to the entire company.
+
+Putting the team allocations in a Discussion allows updates if attendees change or if the teams need to be updated.
+
+![Figure: GitHub Discussion - Team allocations](https://github.com/SSWConsulting/SSW.Rules.Content/assets/38869720/5c7a9a8f-24d8-4129-8060-c34f2cd3afb2)
 
-Having all the presentations in one location makes it easy to collaborate and ensures they wont be lost.
+**Tip:** For extra visibility, also pin it on the repo.

rules/connect-client-im/rule.md

@@ -1,16 +1,16 @@
 ---
 type: rule
 title: Do you know why it’s important to talk to clients on Teams? 
-uri: client-communication-im
+uri: connect-client-im
 authors:
   - title: Asher Paris
     url: https://ssw.com.au/people/
 related:
   - rules-to-better-microsoft-teams
 created: 2023-10-31T16:50:21.000Z
 guid: 4332723e-c780-4d0c-a759-5067404ed8fc
-
 ---
+
 Effective communication with your clients on Microsoft Teams builds credibility, trust and ensures they receive the deserved attention.
 
 <!--endintro-->
@@ -32,22 +32,19 @@ Once you’ve arranged an Initial Meeting or before a Spec Review, follow these
 3. Enter the client’s email address
 4. Create the chat
 
-![Figure: Client with open tenant](teams-rule.png)
-
+![Figure: Client with open tenant](https://github.com/SSWConsulting/SSW.Rules.Content/assets/147477898/202b36bf-f727-470b-ae25-4985aed1ff2c)
 
 ### If the client has an open tenant, you should send a welcome message in Teams.
 
 :::  greybox
 Hey thanks for the meeting. Feel free to ping me on Teams or by email any time if you have any questions 😀 
 :::  
 
-::: Figure: Send an email to your client confirming you will contact them through Teams :::
+**Figure: Send an email to your client confirming you will contact them through Teams**
 
 ### If the client has a closed tenant, you should send a closed tenant request email.
 
-![image (1)](https://github.com/SSWConsulting/SSW.Rules.Content/assets/147477898/49902b0f-f643-4bbf-9305-86e39aae3de3)
-
-**Figure:  Client with closed tenant**
+![Figure: Client with a closed tenant](https://github.com/SSWConsulting/SSW.Rules.Content/assets/147477898/c6cead28-1d2c-45e3-8e3f-d089447de683)
 
 ::: email-template  
 |          |     |

rules/declare-variables-when-you-need-them/rule.md

@@ -1,26 +1,22 @@
 ---
 type: rule
-archivedreason: Rule is outdated. Prefer shorter methods that eliminate the need for this rule
 title: Do you declare variables when you need them?
-guid: 24d23856-bd1a-42c5-b883-793e6c84366a
 uri: declare-variables-when-you-need-them
-created: 2018-04-24T21:55:53.0000000Z
 authors:
-- title: Adam Cogan
-  url: https://ssw.com.au/people/adam-cogan
+  - title: Adam Cogan
+    url: https://ssw.com.au/people/adam-cogan
 related: []
 redirects:
-- do-you-declare-variables-when-you-need-them
-
+  - do-you-declare-variables-when-you-need-them
+created: 2018-04-24T21:55:53.000Z
+archivedreason: Rule is outdated. Prefer shorter methods that eliminate the need for this rule
+guid: 24d23856-bd1a-42c5-b883-793e6c84366a
 ---
-
 Should you declare variables at the top of the function, or declare them when you need to use them? If you come back to your code after a few weeks and you no longer need a variable, you are quite likely to forget to delete the declaration at the top, leaving orphaned variables. Here at SSW, we believe that variables should be declared as they are needed.
 
 <!--endintro-->
 
-
-
-```
+```vbnet
 Private Sub Command0_Click()
 Dim dteTodayDate As Date
 Dim intRoutesPerDay As Integer
@@ -34,19 +30,12 @@ intRoutesPerDay = 2
 End Sub
 ```
 
-
-
-
 ::: bad
 Figure: Bad example 
 
 :::
 
-
-
-
-
-```
+```vbnet
 Private Sub Command0_Click()
 Dim dteTodayDate As Date
 dteTodayDate = Date.Now()
@@ -60,10 +49,7 @@ intRoutesPerDay = 2
 .End Sub
 ```
 
-
-
-
 ::: good
 Figure: Good example
 
-:::
+:::

rules/digesting-brainstorming/rule.md

@@ -1,6 +1,6 @@
 ---
 type: rule
-title: Do you digest brainstorming outcomes?
+title: Do you digest Brainstorming outcomes?
 uri: digesting-brainstorming
 authors:
   - title: Adam Cogan
@@ -18,10 +18,10 @@ 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.
+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.
 
-Create a PBI or send a task for every item that the brainstorming team decides is valuable.
+Create a PBI or send a task for every item that the Brainstorming team decides is valuable.
 
 Send a summary of what was implemented to the company with links to the PBIs.