Resources
Carpentries readings
- Instructors resources
- Greg Wilson, Teaching Tech Together (2019). (web book by SWC founder)
- Neil C. C. Brown and Greg Wilson, “Ten Quick Tips for Teaching Programming”, PLoS Computational Biology, 14(4), April 2018, https://doi.org/10.1371/journal.pcbi.100602
- “The Science of Learning”, Deans for Impact, 2015.
- Porter, Guzdial, McDowell, and Simon, “Success in Introductory Programming: What Works?”, Communications of the ACM Aug 2013: 56, 8. DOI:10.1145/2492007.2492020.
- Wilson G. Software Carpentry: lessons learned [version 2; peer review: 3 approved]. F1000Research 2016, 3:62. DOI: 10.12688/f1000research.3-62.v2
- Feldon, et al. “Graduate Students’ Teaching Experiences Improve Their Methodological Research Skills”, Science 19 Aug 2011: 333, 6045. DOI: 10.1126/science.1204109.
- Wilson G, Aruliah DA, Brown CT, Chue Hong NP, Davis M, Guy RT, et al. (2014) Best Practices for Scientific Computing. PLoS Biol 12(1): e1001745. DOI: 10.1371/journal.pbio.1001745
- Jacobs, et al. “Experiences with efficient methodologies for teaching computer programming to geoscientists”. arXiv:1505.05425
Reference
GitHub
GitHub is a popular web service for hosting Git repositories–with benefits! It provides a handy web interface for editing and collaborating on repos, as well as, built in project management features and free static web hosting powered by Jekyll. Accounts are free. To learn more check out Hello World on GitHub Guides or GitHub Training.
Jekyll
Jekyll is a popular static site generator that is built into GitHub Pages free web hosting service.
- go-go gh-pages (workshop)
Markdown
Markdown is a standard to simplify writing content for the web. GitHub markdown flavor can be used any where on GitHub and in Jekyll.
- Markdown in a Minute
- GitHub Guide Mastering Markdown
- Dillinger (web based markdown editor)
Text Editor
When working with code you should have a good text editor. Windows notepad does not handle UTF-8 encoding or UNIX line endings that are standard for cross platform applications. For basic editing, Windows Notepad++, Mac TextEdit, or Linux Gedit are sufficient. However, a more complete code editor will be helpful for managing Jekyll projects.
Open-source cross platform suggestions: