Check docs are up to date

[ErikSchierboom]

Please check if your documentation files are still up-to-date.

The key documentation files to check are:

• docs/ABOUT.md
• docs/INSTALLATION.md
• docs/LEARNING.md
• docs/RESOURCES.md
• docs/TESTS.md
• exercises/shared/.docs/help.md
• exercises/shared/.docs/tests.md

There might be more.

Link check report

To help identify invalid links, we've automatically checked the links of all *.md files in this repo.
This is the report of that check:

📝 Summary
---------------------
🔍 Total..........170
✅ Successful.....168
⏳ Timeouts.........0
🔀 Redirected.......0
👻 Excluded.........0
🚫 Errors...........2

Errors in ./docs/RESOURCES.md
✗ http://www-cgi.cs.cmu.edu/afs/cs.cmu.edu/user/dst/www/LispBook/index.html (HTTP status client error (404 Not Found) for url (http://www-cgi.cs.cmu.edu/afs/cs.cmu.edu/user/dst/www/LispBook/index.html))

Errors in ./README.md
✗ https://github.com/exercism/common-lisp-representer. (404 Not Found: Not Found)

Tracking

exercism/v3-launch#54

• Review listed docs above for correctness
• fix dead link to LispBook
• fix broken representer link
• change exercism.io & exercism.lol links to be internal links
• correct internal links in: concepts/functions/about.md
• correct internal links in: reference/implementating-a-concept-exercise

[verdammelt]

@ErikSchierboom Lychee looks pretty useful - can you share what command line options you used for this?

[verdammelt]

I used lychee and set a base url of https://exercism.lol and found the following errors:

📝 Summary
---------------------
🔍 Total..........180
✅ Successful.....172
⏳ Timeouts.........0
🔀 Redirected.......0
👻 Excluded.........0
🚫 Errors...........8

Errors in concepts/functions/about.md
✗ https://exercism.lol/rest-parameters/about.md (HTTP status client error (404 Not Found) for url (https://exercism.lol/rest-parameters/about.md))
✗ https://exercism.lol/default-parameters/about.md (HTTP status client error (404 Not Found) for url (https://exercism.lol/default-parameters/about.md))
✗ https://exercism.lol/named-parameters/about.md (HTTP status client error (404 Not Found) for url (https://exercism.lol/named-parameters/about.md))
✗ https://exercism.lol/recursion/about.md (HTTP status client error (404 Not Found) for url (https://exercism.lol/recursion/about.md))
✗ https://exercism.lol/scope/about.md (HTTP status client error (404 Not Found) for url (https://exercism.lol/scope/about.md))

Errors in reference/implementing-a-concept-exercise.md
✗ https://exercism.lol/bin/generate-scaffolding/README.md (HTTP status client error (404 Not Found) for url (https://exercism.lol/bin/generate-scaffolding/README.md))
✗ https://exercism.lol/exercises/concept/socks-and-sexprs (HTTP status client error (404 Not Found) for url (https://exercism.lol/exercises/concept/socks-and-sexprs))
✗ https://exercism.lol/exercises/concept/README.md (HTTP status client error (404 Not Found) for url (https://exercism.lol/exercises/concept/README.md))

Looks like links to concepts etc. are not set up correctly.