csharp icon indicating copy to clipboard operation
csharp copied to clipboard

Improve Concept Link Descriptions

Open mikedamay opened this issue 4 years ago • 0 comments

The descriptions for the links in concepts/**/links.json are based on the markdown arbitrary reference text for reference-style links. For the most part, these work well but some are a bit cryptic.

For instance, the time concept contains links described as skeet-time-of-day and wiki-utc. These are probably better as "time-of-day per Jon Skeet" and "Wikipedia on UTC".

I think brevity is an aspiration for the link descriptions but I think it's worth mentioning the source if it's Stack Overflow or Wikipedia or a well-known authority and their view is adding color to our description of the concept which is covered by more generic links.

mikedamay avatar Feb 12 '21 14:02 mikedamay