🎓 awesome-teachcode

🎓 Resources to use in the classroom, when writing tutorials, lesson plans/learning objectives, and when grading code-based assignments.

Table of Contents {docsify-ignore}

• Community
• Course Tracking
• Deployment
• Diagramming
• Feedback
• Code Reviews
• Learning Objectives
• Presentations
• Recording

Community

• dev.to: Where programmers share ideas and help each other grow. An online community for sharing and discovering great ideas, having debates, and making friends. Anyone can share articles, questions, discussions, etc. as long as they have the rights to the words they are sharing. Cross-posting from your own blog is welcome.

Course Tracking

Use shields.io to embed automated code quality checks and other metrics in course tracking spreadsheets.

How to Embed

Sample code assumes a column named C2 contains a string in username/reponame format. Links to the associated GitHub repo.

Example: droxey/tocsify.

=IF(C2 > 0, HYPERLINK(CONCATENATE("https://github.com/", C2), IMAGE(CONCAT(CONCAT("https://img.shields.io/github/last-commit/", C2), ".svg?style=flat"), 3), "")

Deployment

• Glitch: Glitch is the friendly community where everyone can discover and create the best stuff on the web.
• Heroku: Fully-managed platform; the simplest path to delivering apps quickly.
• Netlify: An all-in-one workflow that combines global deployment, continuous integration, and automatic HTTPS.
• $100/60 Days @ DigitalOcean: Use this promo code to get $100 worth of credit over 60 days at Digital Ocean.

Diagramming

• sketchboard.io: Sketch software architectures, flow diagrams, mind maps, and more. Can share with the public and embed in lesson plans.

Feedback

• Poll Everywhere: Engage your class in real-time. Poll Everywhere transforms one-sided presentations into two-way conversations with an audience. This web-based audience response system lets you embed interactive activities directly into your presentation. The audience responds on the web or via SMS texting on their phones.

Code Reviews

• reviewable.io: GitHub code reviews done right.
• CodeStream: CodeStream is the knowledge base behind your codebase. Your dev team's discussions about code happen right inside the IDE, and are saved permanently with the code blocks to which they refer. That way your team, including its future members, benefits from working with an annotated codebase. With each discussion, your knowledge base grows and your codebase gets smarter over time.
• gitinspector: Statistical analysis tool for git repositories. The default analysis shows general statistics per author, which can be complemented with a timeline analysis that shows the workload and activity of each author. Under normal operation, it filters the results to only show statistics about a number of given extensions and by default only includes source files in the statistical analysis.
• degit: Makes copies of git repositories. Run degit some-user/some-repo, and degit will find the latest commit on https://github.com/some-user/some-repo and download the associated tar file to ~/.degit/some-user/some-repo/commithash.tar.gz if it doesn't already exist locally.

Learning Objectives

• List of Measurable Verbs: A list of measurable verbs to assist you in writing course objectives and assess learning outcomes.
• Objectives Builder: Use the ASU Online Objectives Builder tool to write measurable course outcomes and learning objectives.

Presentations

• reveal.js: Framework for easily creating beautiful presentations using HTML. Features include nested slides, Markdown contents, PDF export, speaker notes and a JavaScript API. Use in conjunction with GitHub Pages for public, sharable, and open source presentations.
• reveal-md: reveal.js on steroids! Get beautiful reveal.js presentations from Markdown files.

Recording

• asciinema: A free and open source solution for recording terminal sessions and sharing them on the web.