Cleanup md files (root folder)

[Jay-o-Way]

Summary of the Pull Request

Cleaning up Markdown files, including:

• Learn Authoring Pack in Visual Studio Code
• consolidating list item bullets
• spelling and grammar
• HTML tables and links to Markdown

To do:

• Sentence casing in headers https://learn.microsoft.com/en-us/style-guide/capitalization#sentence-style-capitalization-in-titles-and-headings
  (Copilot quotum was reached 🤓)
• NOTICE.md: text in code blocks or not??

[niels9001]

@Jay-o-Way Is this ready for review? Reviews were requested by the PR is still in draft so wanted to check :)!

[Jay-o-Way]

Well, i wanted to change the headers too, but my quotum won't reset for another month. Maybe something you would like to add? Besides that, it's finished.

[niels9001]

Well, i wanted to change the headers too, but my quotum won't reset for another month. Maybe something you would like to add? Besides that, it's finished.

I think overall it's looking good. It's just that some changes in the README are regressions, see my comments

[Jay-o-Way]

@niels9001 Thanks! Updated ReadMe.
Would you like to update the headers to use sentence casing? My Copilot reached its quotum.
Oh and we need to choose: text in notice.md: code blocks or no code blocks??

[niels9001]

Eeek

[Jay-o-Way]

It really is about the "details", haha. Fixed!

[Jay-o-Way]

@niels9001 Thanks! I just applied the suggestions, and added the changes of PR 46371, and fixed conflicts.

[github-actions]

@check-spelling-bot Report

🔴 Please review

See the 📂 files view, the 📜action log, or 📝 job summary for details.

Unrecognized words (2)

traies
udit

These words are not needed and should be removed

LPCFHOOKPROC LUMA MAXDWORD MRT runtimeconfig suntimes timespan VSync

To accept these unrecognized words as correct and remove the previously acknowledged and now absent words, you could run the following commands

... in a clone of the git@github.com:Jay-o-Way/PowerToys.git repository
on the cleanup-MD-files branch (ℹ️ how do I use this?):

curl -s -S -L 'https://raw.githubusercontent.com/check-spelling/check-spelling/c635c2f3f714eec2fcf27b643a1919b9a811ef2e/apply.pl' |
perl - 'https://github.com/microsoft/PowerToys/actions/runs/23850209647/attempts/1' &&
git commit -m 'Update check-spelling metadata'

Warnings ⚠️ (1)

See the 📂 files view, the 📜action log, or 📝 job summary for details.

⚠️ Warnings	Count
⚠️ ignored-expect-variant	5

See ⚠️ Event descriptions for more information.

If the flagged items are 🤯 false positives

If items relate to a ...

• binary file (or some other file you wouldn't want to check at all).

  Please add a file path to the excludes.txt file matching the containing file.

  File paths are Perl 5 Regular Expressions - you can test yours before committing to verify it will match your files.

  ^ refers to the file's path from the root of the repository, so ^README\.md$ would exclude README.md (on whichever branch you're using).

• well-formed pattern.

  If you can write a pattern that would match it,
  try adding it to the patterns.txt file.

  Patterns are Perl 5 Regular Expressions - you can test yours before committing to verify it will match your lines.

  Note that patterns can't match multiline strings.

[niels9001]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).

[Jay-o-Way]

Thanks @crutkas and @niels9001 ! Any advice for the point about putting licence texts inside a code block or not? Or not important?