Merge branch 'main' into sg/doc-448-create-vale-word-list-covering-all-ngrokisms

Author: sg-writer

.github/workflows/write-rss.yml

@@ -1,5 +1,5 @@
 extends: existence
-message: "Use 'AM' or 'PM' (preceded by a space)."
+message: "Use 'AM' or 'PM' preceded by a space."
 link: "https://developers.google.com/style/word-list"
 level: error
 nonword: true

.vale/styles/Google/AMPM.yml

@@ -1,5 +1,5 @@
 extends: conditional
-message: "Spell out '%s', if it's unfamiliar to the audience."
+message: "Spell out '%s' if it might be unfamiliar to the audience."
 link: 'https://developers.google.com/style/abbreviations'
 level: suggestion
 ignorecase: false

.vale/styles/Google/Acronyms.yml

@@ -1,5 +1,5 @@
 extends: substitution
-message: "Use '%s' instead of '%s'."
+message: "Use '%s' instead of '%s'—this makes the docs more conversational and friendly."
 link: 'https://developers.google.com/style/contractions'
 level: suggestion
 ignorecase: true

.vale/styles/Google/Contractions.yml

@@ -1,5 +1,5 @@
 extends: existence
-message: "Use parentheses judiciously."
+message: "Use parentheses sparingly—is this parenthetical statement truly necessary?"
 link: 'https://developers.google.com/style/parentheses'
 nonword: true
 level: suggestion

.vale/styles/Google/Parens.yml

@@ -12,7 +12,7 @@ To make changes to the documentation, edit the relevant Markdown files in your l
 
 When making changes, please follow the Markdown style guide and try to keep your changes concise and to the point. If you're making significant changes or adding new content, please consider including examples or other resources to help readers understand the topic better.
 
-Once you have finished making your changes, we recommend you run a local build with mintilify (command pnpm run build) to ensure your contribution will not present errors with links or build. After a successful build, push them to your fork on GitHub and create a pull request to submit your changes for review.
+Once you have finished making your changes, we recommend you run a local build with mintilify (command pnpm run dev) to ensure your contribution will not present errors with links or build. After a successful build, push them to your fork on GitHub and create a pull request to submit your changes for review.
 
 # Code of Conduct