data-lessons / library-data-intro-DEPRECATED

Data intro for librarians NOW MOVED > https://github.com/LibraryCarpentry/lc-data-intro
https://github.com/LibraryCarpentry/lc-data-intro
Other
8 stars 18 forks source link

proposed _episodes #8

Closed ccronje closed 8 years ago

ccronje commented 8 years ago

Split LibCarp-introdata.md into:

01-introduction.md (~15min) 02-jargon-busting.md (45min) 03-foundations.md (45min) 04-regular-expressions.md (45min)

Rename LibCarp-introdata-handout.md to:

05-handout-questions.md

Rename LibCarp-introdata.answers.md to:

06-handout-answers.md

Or should we combine 05 & 06? (it could be considered a 45min episode)

The slide deck files (LibCarp-introdata-deck.pdf/odp) are not episodes so where should they be placed in the new structure? Or would it be better to create an "Instructors' Guide" based on this content? Note: LibCarp-introdata.md references the slide deck with "SLIDE" throughout but this is easy enough to change.

@weaverbel let me know and I'll go ahead with the changes

weaverbel commented 8 years ago

@ccronje - my thoughts (and thanks for all the hard yakka)

+1 to the split +1 to renaming handout +1 to renaming answers -1 to combining 05 and 06 for now Can we turn the slides into markdown - then they can be output in heaps of different ways via pandoc?

ccronje commented 8 years ago

@weaverbel Yes @ptsefton helped me convert the slides (odp file) to markdown - I'll put this in the Instructors' Guide. Aiming to have these things done by tomorrow.

drjwbaker commented 8 years ago

agreed with @weaverbel on the split/not split (answers and handout need to be a separate sheet so it is clear that a) they are printed separately and b) they are handed out separately)

On slides, the SLIDE bits as a Jamesism carried over into public content. If @ccronje can get them into .md that can be pandoced that would be great (and I would learn something, I use pandoc a lot but never for slides)

ccronje commented 8 years ago

The initial pass of this is done. The first PR includes six updated/new _episode files. The header content needs checking across all. I'm sure there is a lot left to tweak - just let me know what to address next. Am new to the DC templates but it is well documented :-)

The second PR is for the slide deck or Instructors' Guide (located at _extras/guide.md). Please double check the slides as the conversion from odp to md inserted a few extra escapes in the regex! I'd like to see how pandoc works with this file too. In ref to #9 the license is now CC BY on the first slide.

drjwbaker commented 8 years ago

@ccronje On the second PR, I couldn't get your guide.md to pandoc to a html slide deck so I made another one that I could easily - with a little reading around - using slidy. If so sync up and open the file it should work fine (needs a little fettling, but it was my first stab!)

ccronje commented 8 years ago

@drjwbaker great job, works a treat - please overwrite guide.md @weaverbel I have Jekyll on my local now so can preview properly - I can see what needs fixing in the episodes so will get onto that this evening.

drjwbaker commented 8 years ago

@ccronje Okay. On your guide.md did that render as a deck for a purpose? No need to get rid of it if it will work as an alternative deck for an alternative setup.

ccronje commented 8 years ago

@drjwbaker it was a first attempt so not fully tested. Fine to remove until I get more experience under belt.

drjwbaker commented 8 years ago

Okay.