dart-lang / site-www

Source for Dart website
https://dart.dev
Other
944 stars 683 forks source link

Incorrect expansion of "Uri" and a highlighting issue in Effective Dart style guide #5995

Closed neko-tail closed 1 month ago

neko-tail commented 2 months ago

Page URL

https://dart.dev/effective-dart/style#do-capitalize-acronyms-and-abbreviations-longer-than-two-letters-like-words

Page source

https://github.com/dart-lang/site-www/blob/main/src/content/effective-dart/style.md#do-capitalize-acronyms-and-abbreviations-longer-than-two-letters-like-words

Describe the problem

URI stands for uniform resource identifier. URLs (uniform resource locators) are a common kind of URI.

good:

Uri // "uniform resource locator"

bad:

URI // "uniform resource locator"

Expected fix

good:

Uri // "uniform resource identifier"

bad:

URI // "uniform resource identifier"

or

good:

Url // "uniform resource locator"

bad:

URL // "uniform resource locator"

Additional context

No response

I would like to fix this problem.

RedBrogdon commented 2 months ago

Hrmm. Looks like there's a highlighting issue with "esq" in that block as well:

image