swcarpentry/lesson-template — pull request #65 by abought (2014-12-19 06:05:15+00:00)
Title: Make templates consistent with how links are checked

These changes would enable simpler, more consistent link validation by changing the sample files so that they all follow the same rules. Yes, the validator is that pedantic... sorry, @gvwilson . ;)

This is an alternate proposal that would allow us to eliminate special casing for links to `index.html`, `discussion.html`, `reference.html`, and `motivation.html`. It is in reference to comments on another pull request: swcarpentry/lesson-template/#58

### What to merge
Changes to .md files can be merged as-is.

If there are conflicts in tools/check, take the other version. The validator edits herein are solely meant to demonstrate that when the template is consistent, pages will validate without resorting to special-casing and complex code.

I added an extra YAML header to motivation.md. It doesn't seem to change the resulting HTML- confirm?

### Background
When the validator sees a link to a local .md file, it checks that:
a. There is a matching .md file, and
b. The text of the link matches the *subtitle* YAML header of the destination file.

In their current form, some pages did not follow these rules. (eg index.md linked to "Discussion" as "Next Steps", and motivation.md did not have a subtitle node to check for rule b).