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: unify format of notes #17294

Merged
merged 18 commits into from
Feb 13, 2023
Merged

docs: unify format of notes #17294

merged 18 commits into from
Feb 13, 2023

Conversation

i582
Copy link
Contributor

@i582 i582 commented Feb 12, 2023

NB, N.B., Note, NOTE, Please note replaced with **Note**

One common standard allows the reader to better navigate the material.
Also "Note" is more understandable to non-native speakers than "NB".
Highlighting each note as a quote also makes it easier to notice them than if they are written in the same style as other text.

Example:

Снимок экрана 2023-02-12 в 20 26 57

See also: community/community#16925

i582 added 2 commits February 12, 2023 19:36
@i582 i582 requested a review from spytheman February 12, 2023 15:55
@i582 i582 added the Unit: Documentation Bugs/feature requests, that are related to the documentations. label Feb 12, 2023
Comment on lines -149 to +153
**Important Note:** *Consecutive dots, for example `...`, are not allowed.*
*This will cause a syntax error. Use a quantifier instead.*
> Important Note: Consecutive dots, for example `...`, are not allowed.
> This will cause a syntax error. Use a quantifier instead.
Copy link
Member

@spytheman spytheman Feb 13, 2023

Choose a reason for hiding this comment

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

The previous wording/formatting here was more distinct imho.

@spytheman spytheman merged commit c8c70de into vlang:master Feb 13, 2023
l1mey112 pushed a commit to l1mey112/v that referenced this pull request Jun 7, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Unit: Documentation Bugs/feature requests, that are related to the documentations.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants