Where can I get help?
Mail , or join our discussion list and ask for help there.
Where can I report problems or suggest improvements?
Please file an issue or .
Why does the lesson repository have to be created from scratch? Why not fork lesson-template
on GitHub?
Because any particular user can only have one fork of a repository, but instructors frequently need to work on several workshops at once.
Why use Pandoc? Why not some other markup language and some other converter?
Because it supports a richer dialect of Markdown than Jekyll (the converter that GitHub uses by default). In particular, Pandoc can do tables and allows us to add styles to headings.
What do the labels mean?
bug
: something is wrong in our tools or documentationdefer
: marks an issue that we will work on, but not nowdiscussion
: marks issues used for conversations about specific problems and questionsduplicate
: marks an issue that was closed as redundant (include the number of the original issue in the closing comment)enhancement
: asks for, or adds, a new feature or new informationfiled-by-newcomer
: issue or pull request was filed by someone who is relatively new to GitHub and/or this project, and would appreciate guidance as well as feedbackgetting-started
: issue or pull request is suitable for someone new to GitHub and/or this projecthelp-wanted
: a question or request for assistanceleft-as-was
: marks an issue closed because the item in question will be left as it wassuitable-for-newcomer
: issue or pull request is a good starting point for someone who is relatively new to GitHub and/or this projectwork-in-progress
: a pull request that is not yet ready for reviewPlease add notes about problems and solutions below.