C# Dev Kit popup message is written in an inconsistent and extremely casual style

jnm2 commented 3 months ago

Visual Studio Version

C# Dev Kit v1.7.27 in Visual Studio Code

Summary

This message is written in an unexpectedly casual style for software:

It's breaking an English grammar rule by joining two independent clauses with a comma without a conjunction. Shorter sentences can be easier to read, so I would recommend splitting into two sentences.
It's missing a period. https://learn.microsoft.com/en-us/windows/win32/uxguide/text-ui#punctuation:
Periods
- Don't place at the end of control labels, main instructions, or Help links.
- Place at the end of supplemental instructions, supplemental explanations, or any other static text that forms a complete sentence.
It's an odd choice to capitalize 'Solution' and also an odd choice not to use the branding capitalization for 'intellisense' since that's a proper noun/brand name. https://learn.microsoft.com/en-us/windows/win32/uxguide/text-ui#capitalization:
- For feature and technology names, be conservative in capitalizing. Typically, only major components should be capitalized (using title-style capitalization).
  
  Correct:
  
  Analysis Services, cubes, dimensions
  
  Analysis Services is a major component of SQL Server, so title-style capitalization is appropriate; cubes and dimensions are common elements of database analysis software, so it is unnecessary to capitalize them.
See also https://learn.microsoft.com/en-us/style-guide/grammar/nouns-pronouns#capitalization-and-proper-nouns, for instance, for why it would be 'solution' and not 'Solution':

If there's more than one of a thing, it's a common noun. For example, there are lots of chief operating officers, so chief operating officer is a common noun. There's only one Chief Operating Officer Latasha Sharp, so that's a proper noun.

Don't capitalize common nouns unless they begin a sentence or the situation calls for title-style capitalization. Most technology concepts, product categories, devices, and features are common nouns, not proper nouns. Examples of common nouns include cloud computing, smartphone, e-commerce, and open source.