Skip to content

Commit

Permalink
XS✔ ◾ fixes frontmatter (#7472)
Browse files Browse the repository at this point in the history
* fixes

* Auto-fix Markdown files

* fix guid

* more fixes

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
  • Loading branch information
JackDevAU and github-actions[bot] authored Dec 7, 2023
1 parent df83e61 commit 808fdb1
Show file tree
Hide file tree
Showing 42 changed files with 307 additions and 283 deletions.
14 changes: 10 additions & 4 deletions rules/avoid-unnecessary-css-classes/rule.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,40 +4,46 @@ title: Do you avoid adding unnecessary CSS classes?
uri: avoid-unnecessary-css-classes
authors:
- title: Geordie Robinson
noimage: true
url: https://www.ssw.com.au/people/geordie-robinson/
- title: Tiago Araujo
url: https://www.ssw.com.au/people/tiago-araujo
created: 2022-07-28T06:06:37.551Z
guid: ca1b7770-298b-4035-b45d-a570fa0ee77b

---

When making or editing CSS or HTML content it is important to avoid adding classes and ID's unnecessarily.
When making or editing CSS or HTML content it is important to avoid adding classes and ID's unnecessarily.

It can be tempting to add classes on elements, as it is often the most obvious solution to CSS problems... but doing so will lead to overly cluttered code and a host of overly specific solutions. When working on CSS it is almost always better to reuse rather than adding additional classes.
It can be tempting to add classes on elements, as it is often the most obvious solution to CSS problems... but doing so will lead to overly cluttered code and a host of overly specific solutions. When working on CSS it is almost always better to reuse rather than adding additional classes.

<!--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 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.

HTML:

```html
<a class="view-all-link" href="https://www.youtube.com/playlist?list=PLIzW_0dAIKv3mjBeK8eyJbe1bOGWJX_UV">View All</a>
```

CSS:

```css
.view-all-link{
margin-top: 0;
}
```

::: bad
Figure: Bad example - The "view-all-link" class was added unnecessarily
:::

HTML:

```html
<a class="mt-0" href="https://www.youtube.com/playlist?list=PLIzW_0dAIKv3mjBeK8eyJbe1bOGWJX_UV">View All</a>
```

::: good
Figure: Good example - Using [Bootstrap's class "mt-0"](https://getbootstrap.com/docs/4.0/utilities/spacing/) has the same affect without adding any class
:::
17 changes: 8 additions & 9 deletions rules/blazor-learning-resources/rule.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ archivedreason:
title: Do you know the best Blazor learning resources?
guid: 0aa14e3c-52d5-45e9-97a1-7975beed9db7
uri: blazor-learning-resources
created: 2022-3-28T07:48:45.0000000Z
created: 2022-03-28T07:48:45.0000000Z
authors:
- title: Brady Stroud
url: https://ssw.com.au/people/brady-stroud
Expand All @@ -15,11 +15,10 @@ redirects:

Prepare for the future of web development by checking out these Blazor learning resources.

- [Blazor Train](https://blazortrain.com/)
- [Blazor WASM by example](https://www.packtpub.com/product/blazor-webassembly-by-example/9781800567511)
- [Modern Web Dev with Blazor and .NET 6 with Jason Taylor](https://youtu.be/lRYrhj9lwQk)
- [Microsoft Blazor tutorial](https://dotnet.microsoft.com/en-us/learn/aspnet/blazor-tutorial/intro)
- [Microsoft Learn](https://learn.microsoft.com/en-au/aspnet/core/blazor)
- [Performance Best Practices](https://learn.microsoft.com/en-us/aspnet/core/blazor/performance)
- [Blazor in action](https://www.manning.com/books/blazor-in-action)

* [Blazor Train](https://blazortrain.com/)
* [Blazor WASM by example](https://www.packtpub.com/product/blazor-webassembly-by-example/9781800567511)
* [Modern Web Dev with Blazor and .NET 6 with Jason Taylor](https://youtu.be/lRYrhj9lwQk)
* [Microsoft Blazor tutorial](https://dotnet.microsoft.com/en-us/learn/aspnet/blazor-tutorial/intro)
* [Microsoft Learn](https://learn.microsoft.com/en-au/aspnet/core/blazor)
* [Performance Best Practices](https://learn.microsoft.com/en-us/aspnet/core/blazor/performance)
* [Blazor in action](https://www.manning.com/books/blazor-in-action)
31 changes: 16 additions & 15 deletions rules/chain-of-density/rule.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ related:
- summarize-long-conversations
- fundamentals-of-prompt-engineering
- critical-agent
created: 2023-09-19
created: 2023-09-19T00:00:00Z
archivedreason: null
guid: b962b722-e7a8-42ed-b045-f8f2e4c7bd1b
---
Expand All @@ -24,9 +24,9 @@ CoD prompting is a useful way to reduce the chances that ChatGPT makes mistakes

When you give it the prompt, it will:

- Add important stuff step by step
- Critique itself to check quality
- Improve its own summary
* Add important stuff step by step
* Critique itself to check quality
* Improve its own summary

Here's an example prompt you can use to do CoD - the only thing you need to to is paste the text you want summarized into the {{ ARTICLE }} placeholder:

Expand All @@ -40,20 +40,21 @@ Step 1. Identify 1-3 informative entities (";" delimited) from the article which
Step 2. Write a new, denser summary of identical length which covers every entity and detail from the previous summary plus the missing entities.

A missing entity is:
- relevant to the main story,
- specific yet concise (5 words or fewer),
- novel (not in the previous summary),
- faithful (present in the article),
- anywhere (can be located anywhere in the article).

* relevant to the main story,
* specific yet concise (5 words or fewer),
* novel (not in the previous summary),
* faithful (present in the article),
* anywhere (can be located anywhere in the article).

Guidelines:

- The first summary should be long (4-5 sentences, ~80 words) yet highly non-specific, containing little information beyond the entities marked as missing. Use overly verbose language and fillers (e.g., "this article discusses") to reach ~80 words.
- Make every word count: rewrite the previous summary to improve flow and make space for additional entities.
- Make space with fusion, compression, and removal of uninformative phrases like "the article discusses".
- The summaries should become highly dense and concise yet self-contained, i.e., easily understood without the article.
- Missing entities can appear anywhere in the new summary.
- Never drop entities from the previous summary. If space cannot be made, add fewer new entities.
* The first summary should be long (4-5 sentences, ~80 words) yet highly non-specific, containing little information beyond the entities marked as missing. Use overly verbose language and fillers (e.g., "this article discusses") to reach ~80 words.
* Make every word count: rewrite the previous summary to improve flow and make space for additional entities.
* Make space with fusion, compression, and removal of uninformative phrases like "the article discusses".
* The summaries should become highly dense and concise yet self-contained, i.e., easily understood without the article.
* Missing entities can appear anywhere in the new summary.
* Never drop entities from the previous summary. If space cannot be made, add fewer new entities.

Remember, use the exact same number of words for each summary."
:::
Expand Down
6 changes: 4 additions & 2 deletions rules/change-link-sharing-default-behaviour/rule.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@ title: Do you change link sharing default behaviour?
uri: change-link-sharing-default-behaviour
authors:
- title: Warwick Leahy
url: warwick-leahy
url: https://www.ssw.com.au/people/warwick-leahy/
- title: Jean Thirion
url: jean-thirion
url: https://www.ssw.com.au/people/jean-thirion/
created: 2022-02-07T00:14:18.003Z
guid: 086a184c-b63f-4726-9eb7-bfd6fef3432a
---
Expand All @@ -25,6 +25,7 @@ The consequence in SharePoint is that unique permissions are applied to the indi
To fix the issue you need to change the default sharing method. There are 2 ways to do this - manually via the GUI or programmatically via PNP.PowerShell.

## Method 1 - Manually via SharePoint Admin GUI

1. In the SharePoint Admin site select the SharePoint site and click Sharing
![Figure: Select Sharing](defaultsharinglinktype1.png)

Expand Down Expand Up @@ -57,4 +58,5 @@ foreach ($Url in $Hub)
Set-PnPTenantSite -Url $Url -DefaultLinkToExistingAccess $true
}
```

**Figure: PowerShell to change default link sharing behaviour that affects security**
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ title: Do you change message size restrictions in Exchange Online?
uri: change-message-size-restrictions-exchange-online
authors:
- title: Chris Schultz
url: https://www.ssw.com.au/people/chris-schultz/
related:
- do-you-avoid-huge-images-or-attachments-in-your-email
created: 2022-02-09T23:16:53.094Z
Expand Down
6 changes: 3 additions & 3 deletions rules/choose-an-enterprise-password-manager/rule.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: Do you know how to choose an Enterprise Password Manager?
uri: choose-an-enterprise-password-manager
authors:
- title: Warwick Leahy
url: www.ssw.com.au/people/warwick-leahy
url: https://ssw.com.au/people/warwick-leahy
created: 2022-12-14T11:38:54.394Z
guid: 032f90ed-1492-4222-9b22-7a33d4a98fb0
---
Expand All @@ -17,7 +17,7 @@ These are must have features:

<!--endintro-->

1. **Single sign on with Azure AD** - It would be ironic for a password manager to require staff to remember another password when the intent is to stop them remembering passwords, so it is essential that a good password manager leverages your existing security information. Also with Azure AD staff already have security groups, they already have MFA and access to very advanced conditional access policies, such as impossible travel and trusted devices.
1. **Single sign on with Azure AD** - It would be ironic for a password manager to require staff to remember another password when the intent is to stop them remembering passwords, so it is essential that a good password manager leverages your existing security information. Also with Azure AD staff already have security groups, they already have MFA and access to very advanced conditional access policies, such as impossible travel and trusted devices.

A good Enterprise Password Manager should take advantage of all the same policies. Also by using auto-provisioning they will automatically gain access to the passwords that an administrator gives them access to when a user is created and given the correct security group access and more importantly lose access to passwords when an account is disabled or they are removed from a security group.

Expand Down Expand Up @@ -48,4 +48,4 @@ These are must have features:

::: good
![Figure: Good example - Reporting in Keeper is excellent](keeper-reporting.png)
:::
:::
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,14 @@ title: Control Choice - Do you know when to use CheckBoxes?
uri: control-choice-do-you-know-when-to-use-checkboxes
authors:
- title: Ken Shi
url: https://www.ssw.com.au/people/ken-shi/
related: []
redirects: []
created: 2012-11-27T08:51:11.000Z
archivedreason: null
guid: 3176b22d-ed88-4909-8a77-3e6e652eae7e
---
Checkboxes are presented as small square box in user interfaces. It has two states: checked and unchecked.
Checkboxes are presented as small square box in user interfaces. It has two states: checked and unchecked.

<!--endintro-->

Expand Down Expand Up @@ -46,11 +47,11 @@ The bad thing about having a ComboBox in this scenario is the user needs 2 click
2. Then click the option to select

::: bad
![Figure: Bad example - ComboBox is used for "Job Type" where it contains only 2 options](notusingradiobuttons.gif)
![Figure: Bad example - ComboBox is used for "Job Type" where it contains only 2 options](notusingradiobuttons.gif)
:::

The good thing about an options group is that the user can see all the available options without clicking, and select the option with just 1 click.

::: good
![Figure: Good example - Radio Buttons are used and aligned vertically](usingradiobuttons.gif)
:::
:::
11 changes: 6 additions & 5 deletions rules/devops-board-styles/rule.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ title: Do you customize your DevOps board styles?
uri: devops-board-styles
authors:
- title: Landon Maxwell
url: https://www.ssw.com.au/people/landon-maxwell/
created: 2023-04-17T01:21:50.451Z
guid: 65160ec8-fe38-44b0-bb0a-3f6faafd446d

Expand All @@ -17,11 +18,11 @@ They are also highly customizable, which means you can communicate additional in

Using the styling rules in your DevOps Board, you can use conditional formatting to color-code or add visual tags based on specific criteria, including:

- Setting a PBI as a Sprint Goals
- Who they are assigned to
- High-priority items
- Stale/old tasks (e.g. if a task or PBI has remained unchanged for a number of days)
* Setting a PBI as a Sprint Goals
* Who they are assigned to
* High-priority items
* Stale/old tasks (e.g. if a task or PBI has remained unchanged for a number of days)

To learn how to customize your board, see the walkthrough video below:

`youtube: https://www.youtube.com/embed/lKNVn4PqxAI`
Expand Down
2 changes: 1 addition & 1 deletion rules/do-you-place-your-slicers-consistently/rule.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ archivedreason:
title: Do you place your slicers consistently?
guid: dd6c259e-5fd9-4629-bfa5-dd7523975aac
uri: do-you-place-your-slicers-consistently
created: 2021-05-11
created: 2021-05-11T00:00:00.000Z
authors:
- title: Ulysses Maclaren
url: https://ssw.com.au/people/uly
Expand Down
10 changes: 5 additions & 5 deletions rules/do-you-use-access-packages/rule.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,11 @@ title: Do you use Entra Access Packages to give access to resources?
uri: do-you-use-access-packages
authors:
- title: Warwick Leahy
url: www.ssw.com.au/rules/warwick-leahy
url: https://ssw.com.au/rules/warwick-leahy
created: 2023-08-23T06:08:34.119Z
guid: 86623c40-7433-4723-82a0-9517b28e9079
---
In today's complex digital landscape, managing user access to resources can be a daunting task for organizations. Entra Access Packages emerge as a game-changer in this scenario, offering a streamlined and efficient approach to identity and access management.
In today's complex digital landscape, managing user access to resources can be a daunting task for organizations. Entra Access Packages emerge as a game-changer in this scenario, offering a streamlined and efficient approach to identity and access management.

By bundling related resources into cohesive packages, they simplify the process of granting, reviewing, and revoking access. This not only reduces administrative overhead but also enhances security by ensuring that users have the right permissions at the right time. Furthermore, with built-in automation features like approval workflows and periodic access reviews, organizations can maintain a robust and compliant access governance structure. Adopting Azure Access Packages is a strategic move for businesses aiming to strike a balance between operational efficiency and stringent security.

Expand All @@ -27,7 +27,7 @@ In the old-fashioned way, users would send an email to the SysAdmins requesting
| Subject: | Request for Access to SugarLearning Prod |
::: email-content

### Dear SysAdmins,
### Dear SysAdmins

I would like to request access to SugarLearning Prod as Contributor. Please grant me the necessary permissions.

Expand Down Expand Up @@ -58,7 +58,7 @@ Instead of manually sending emails, users can request access through `myaccess.m
![Request Access](screenshot-2023-08-23-215532.png)
4. Wait for **approval** from the people responsible for the resource

:::greybox
:::greybox
**If you require immediate access ping them on Teams**
:::

Expand All @@ -83,4 +83,4 @@ Instead of manually sending emails, users can request access through `myaccess.m
![Figure: Choose policies that match the level of access](screenshot-2023-08-23-222210.png)
6. **Review and Create**: Ensure all details are correct and then create the access package.

![Figure: Review the settings and create the policy](screenshot-2023-08-23-222746.png)
![Figure: Review the settings and create the policy](screenshot-2023-08-23-222746.png)
5 changes: 3 additions & 2 deletions rules/do-you-use-slido/rule.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,17 +4,18 @@ title: Do you use Slido to interact with your audience?
uri: do-you-use-slido
authors:
- title: Ken Shi
url: https://www.ssw.com.au/people/ken-shi/
created: 2022-08-16T05:31:15.791Z
guid: 97579616-5b48-4ac8-9638-0c261072f2cc
---
Slido is an online platform which provide the easiest way to collect questions for your Q&A sessions, it also run interactive presentations with a top-rated live polling tool.

<!--endintro-->

You can ask your audience to scan QR code to send questions, the audience also can see and upvote the best questions on their mobile devices. You can approve and display the best questions on the presentation screen and highlight the ones that are being answered. All questions are automatically saved for export and analysis.
You can ask your audience to scan QR code to send questions, the audience also can see and upvote the best questions on their mobile devices. You can approve and display the best questions on the presentation screen and highlight the ones that are being answered. All questions are automatically saved for export and analysis.

![Figure: Slido live Q&A's participant view and host view](liveqa.jpg "Figure: Slido live Q&A's participant view and host view")

Live polls are a great way to collect thoughts and engage with audience. You can do all different types of polls with Slido, such as multiple choice, rating and open text. You can display the poll on the presentation screen with the results updated in realtime.
Live polls are a great way to collect thoughts and engage with audience. You can do all different types of polls with Slido, such as multiple choice, rating and open text. You can display the poll on the presentation screen with the results updated in realtime.

![Figure: Slido live polls' participant view and host view](livepolls.jpg "Figure: Slido live polls' participant view and host view")
6 changes: 4 additions & 2 deletions rules/google-maps-profile/rule.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ uri: google-maps-profile
authors:
- title: Seth Daily
url: https://www.ssw.com.au/people/seth-daily
created: 2023-07-30
created: 2023-07-30T00:00:00.000Z
archivedreason: null
guid: d60a52fb-9b90-4abf-812e-0696ec4697c3
related:
Expand All @@ -19,14 +19,15 @@ Ever landed on a business's Google Maps profile only to find scant information,
<!--endintro-->

### Compelling Images

Images are the first thing that someone looks at when clicking on a Google Maps listing. High-resolution photos make your profile appealing, and can be the difference between someone contacting you or bouncing from your page. These could include images of your products, services, team, or business premises.

1. Take high quality pictures - This is the most important part. If your images are blurry or low resolution, viewers immediately start off on the wrong foot with you.
2. Take pictures of the building - Google Maps is full of fake businesses and outdated listings. Having images of the exterior of the building confirms quickly to somebody clicking on your listing that you are legitimate.
3. Add images of interesting features - The cherry on top is to add pictures of interesting features of the office that make it seem personable.


### Profile Information

Make sure your business information is up to date. The important fields are:

* Business name
Expand All @@ -35,4 +36,5 @@ Make sure your business information is up to date. The important fields are:
* Business hours

### Respond to Reviews

It shows a commitment to customer satisfaction if you respond to reviews (especially negative ones). It's important to periodically respond to reviews so that anybody scanning your profile sees that activity.
Loading

0 comments on commit 808fdb1

Please sign in to comment.