lesson-example

lesson-example copied to clipboard

ep 3: syllabus.html

1

Hello! I'm working through making an new lesson, and in episode 3 here, under 'starter files' -> 'index', it says to include syllabus.html after the .prereq block. I cannot see...

KerensaMcElroy

Using RMarkdown need better "Key Points"

2

"It shouldn’t be difficult" can be harmful to novices. @swcarpentry/r-maintainers please provide better key points.

rgaiacs

ep6: Do not use subheadings -- really?

4

In [episode 4](http://carpentries.github.io/lesson-example/04-formatting/index.html) there is a recommendation not to use sub-titles in episodes. Perhaps it's a wording ambiguity, but that very page (and indeed the whole lesson example repo) makes...

gcapes

This is related to https://github.com/carpentries/instructor-training/issues/639. http://swcarpentry.github.io/lesson-example/06-style-guide/index.html should mention the "correct" way to mention the organisation. Also, would be good if our validation tool check for it.

rgaiacs

Add SVG style guide

1

Following up with https://github.com/swcarpentry/lesson-example/issues/171 and https://github.com/swcarpentry/styles/pull/203, we might need to clean up SVG files until Firefox or LibreOffice developers fix some issues, see links in the issue link before. I...

rgaiacs

It is awkward that this is both a template and instructions

4

I think it is very useful to have a template lesson to easily create new lessons. However this repository also contains important information about creating/maintaining lessons. I think those two...

remram44

Refer learners to exercism.io or other practice resources after lesson?

5

Hello :-) This is a repost of [carpentries/mentoring#31](https://github.com/carpentries/mentoring/issues/31) where this repo was mentioned as a more fitting location. How about mentioning some relevant resources like the [exercism.io language tracks](http://exercism.io/languages/) at...

katrinleinweber

Notes about translations workflows

1

There's two main ways we need to decide how they are going to work: 1. English as master - other languages as translations 2. All the languages go in their...

dpshelio

Moving to a lesson release hosting scheme

6

While I know we love living on the development branch 😬 for our lessons, I've been chewing on an idea to better streamline how we build and maintain the web...

jduckles

There is interest in putting some challenges throughout the lessons, so that they are in the location where the instructors will be using them as they go. https://github.com/swcarpentry/shell-novice/issues/552 The original...

tracykteal