Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Standardize "Note" blockquote usage #11724

Merged
merged 2 commits into from May 13, 2024

Conversation

danilo-leal
Copy link
Contributor

@danilo-leal danilo-leal commented May 12, 2024

Standardize the blockquote "Notes" usage, so all places are using the > blockquote notation, as well as a consistent style for the "Note" word.

PS: Thought that bolding the word "Note" would make for a higher visual distinction, so went for it in all existing cases! No strong feelings, though; happy to roll back to just "Note:" if that's preferrable!

Release Notes:

  • N/A

@cla-bot cla-bot bot added the cla-signed The user has signed the Contributor License Agreement label May 12, 2024
@maxdeviant maxdeviant self-assigned this May 13, 2024
Copy link
Member

@maxdeviant maxdeviant left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you, this looks much better!

@maxdeviant maxdeviant merged commit 2e8197c into zed-industries:main May 13, 2024
9 checks passed
@danilo-leal danilo-leal deleted the standardize-note-usage branch May 13, 2024 13:42
osiewicz pushed a commit to RemcoSmitsDev/zed that referenced this pull request May 18, 2024
Standardize the blockquote "Notes" usage, so all places are using the
`>` blockquote notation, as well as a consistent style for the "Note"
word.

PS: Thought that bolding the word "**Note**" would make for a higher
visual distinction, so went for it in all existing cases! No strong
feelings, though; happy to roll back to just "Note:" if that's
preferrable!

Release Notes:

- N/A
SomeoneToIgnore pushed a commit that referenced this pull request May 25, 2024
Mostly tiny stuff. Quick run-down of the changes:
- Using `*Note*` instead of `NOTE` for the blockquote callouts
(piggybacking from #11724)
- Use hyphens for bullet lists instead of asterisks
- Capitalize every (applicable) mention to Zed
- Capitalize mentions of other products (e.g., google cloud → Google
Cloud)
- Swap e.g. → for example — for clarity (latinisms may be unfamiliar for
some non-native English speakers, surprisingly!)

Release Notes:

N/A
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
cla-signed The user has signed the Contributor License Agreement
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants