Grammar mistake

[kq1231]

Page URL

https://dart.dev/tools/linter-rules/use_build_context_synchronously.html

Page source

https://github.com/dart-lang/site-www/tree/main/src/content/tools/linter-rules/individual-rules.md

Describe the problem

There's a grammar mistake.

Expected fix

Storing BuildContext for later usage can easily lead to difficult-to-diagnose crashes. Asynchronous gaps are implicitly storing BuildContext and are some of the easiest to overlook when writing code.

"difficult-to-diagnose" should be hyphenated as it is a compound adjective describing "crashes."

Additional context

No response

I would like to fix this problem.

• I will try and fix this problem on dart.dev.

[MaryaBelanger]

@bwilkerson use_build_context_synchronously seems to be one of those shared names you explained to me recently. So, where do we apply this fix? I'm guessing in the shared name description in diagnostics.md. But I also see the same line under deprecatedDetails for one of the unique names in messages.yaml, so I'm just making sure. Thanks!

[bwilkerson]

The source for the Diagnostic Messages page lives in the messages.yaml file in the linter package.

The diagnostic.md file is generated from the content in messages.yaml.

The deprecatedDetails section (also in messages.yaml) is what's published on https://dart.dev/tools/linter-rules/use_build_context_synchronously.

So it sounds like there are probably two places in the same file that need to be updated.

[parlough]

Resolved by dart-lang/sdk#57093 and dart-lang/sdk@107995f. Thanks all!