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

Improve Concept Link Descriptions #1502

Open
mikedamay opened this issue Feb 12, 2021 · 0 comments
Open

Improve Concept Link Descriptions #1502

mikedamay opened this issue Feb 12, 2021 · 0 comments

Comments

@mikedamay
Copy link
Contributor

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.

@ErikSchierboom ErikSchierboom added x:action/improve Improve existing functionality/content x:knowledge/elementary Little Exercism knowledge required x:module/concept Work on Concepts x:size/s labels Jun 10, 2021
@github-actions github-actions bot removed the x:size/s label Jun 10, 2021
@ErikSchierboom ErikSchierboom removed x:action/improve Improve existing functionality/content x:knowledge/elementary Little Exercism knowledge required x:module/concept Work on Concepts labels Jun 22, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants