Inconsistent labeling of Note/Warning blocks

[akordowski]

Code of Conduct

• I have read and agree to the GitHub Docs project's Code of Conduct

What article on docs.github.com is affected?

Reading the GitHub Actions documentation I have noticed that the labeling of Note/Warning blocks is inconsistent through the documentation. Is that intentional or can be this seen as a bug?

>[!NOTE]

**Note:** or **Notes:**

>[!WARNING]

**Warning:**

What part(s) of the article would you like to see updated?

My first search in the repository indicates that it affects other docs as well. It would be nice if the docs would have a consistent way to display the blocks (preferably the >[!NOTE] / >[!WARNING] notation), and not have different kinds even in same article.

Additional information

If whished I could provide a PR to fix this issue.

[welcome]

Thanks for opening this issue. A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

[nguyenalex836]

@akordowski Thank you for catching this inconsistency! ✨ Notes and warnings should be consistent with the formatting laid out by our style guide 💛

Please feel free to open a PR to update this whenever you have a chance - thank you!

[Piyush-r-bhaskar]

Hi @akordowski

I would like to fix this inconsistency. Would it be fine for you if I take this one if you are not already about to open a PR.

Thanks

[akordowski]

@Piyush-r-bhaskar I already started with the work, so maybe next time.

[akordowski]

PR is available #35216. This was lot of work 😌

[akordowski]

@nguyenalex836 I have further questions for clarification.

1. There were several cases where the docs contained alerts as the following example:

   {% tip %}
   **Note:** description
   {% endtip %}
   
   // or
   
   {% warning %}
   **Note:** description
   {% endwarning %}
   
   // or other combinations

   For this cases I always prefered the prefix (**Note:**) for the Markdown notation (> [!NOTE]) over the liquid ({% tip %}) notation. Is that correct?

2. And there are cases where the docs contain alerts without any prefix in the description:

   {% note %}
   Descriiption
   {% endnote %}

   These cases I didn't changed and kept them as the are. Is that correct or should I change them to the corresponding Markdown notation (> [!NOTE]) as well?

Looking forward for your feedback. Thank you!

[nguyenalex836]

@akordowski 👋

For this cases I always prefered the prefix (Note:) for the Markdown notation (> [!NOTE]) over the liquid ({% tip %}) notation. Is that correct?

Great catch - yes, this is correct! ✨ A snippet from our style guide confirms this -

Liquid syntax for alerts is still supported and may still appear in older articles, but should not be used for new alerts.

---

And there are cases where the docs contain alerts without any prefix in the description

Go ahead and leave leave those as they are - good call 💛

[akordowski]

@nguyenalex836 As discussed I splited the original PR #35216 into 4 new ones:

• Fix inconsistent alerts by using the markdown notation - part 1 #35220
• Fix inconsistent alerts by using the markdown notation - part 2 #35221
• Fix inconsistent alerts by using the markdown notation - part 3 #35222
• Fix inconsistent alerts by using the markdown notation - part 4 #35223

I will close the original PR.