Jeckyl Formatting

[brymz]

(For down the road.)

I saw the newest Software Carpentry lesson (http://swcarpentry.github.io/web-data-python/) and it made me think about the way we format our exercises and how that will look when rendered by Jeckyl.

I'd like to look through a couple examples to gather some thoughts and chat with you sometime. We can also look through some of the Data Carpentry lessons, though they like look they are still mostly 'generic' github wiki pages.

[brymz]

One version of syllabus and schedule.
Assignments - ?
index.md in root - update to one 'course'
exercises/index.md - auto generate
_includes/sidebar - will change to match new structure.
_layouts - change formatting for different page types

[brymz]

Some thoughts after looking through the Jekyll documentation...I really like how they flag important things. However, I felt I didn't get much out of the content in between because the flags were so commanding. This is similar to my thoughts on how many different types of flags / box types there are in Software Carpentry lessons. My take away is that it is important to use flags like road markers that tell you where you are and what is interesting without you driving off the road.

[brymz]

"2nd Pass" Assignment Formatting is described by issues with the "formatting" label.

Issues: #31, #35, #53, #55, #62, #79, #95. (I missed smart quotes [#53] on multiple occasions, will pass through again for those and to make sure everything is a ".)

Related PRs : #116, #117, #124, #125, #129, #130, #131, #133, #132, #134

[brymz]

I think we've sufficiently addressed this. If we decide in the future to overhaul the formatting of the website we can open a new issue.