a0m0rajab/awesome-campus-expert

🕶 An awesome list of resources for campus experts! 🕶

Resources marked with a 🚩 have been created by campus experts

Contents

• Learn
  • Git
  • Markdown
• Workshops
  • Tips
  • Teaching
  • Slide Resources
• Writing
  • Tools
  • Content Guides
• Open Source
  • Find projects
• Community
  • Management

Learn

Resources for learning or teaching languages, techniques, skills etc.

Git

• tryGit - A 15 minute introduction to git in the terminal.
• Learn Git Branching - Interactive lesson which visualises branches and commits
• GitHub Flow - Guide that explains how and why GitHub Flow work
• On Demand Training - On demand training material for various Git and GitHub tools such a command line and GitHub Pages
• GitHub training resources - Extensive collection of battle tested resources from documentation to training slides and cheat sheets
• 🚩 Lionex/github-workshop - Originally created for HackFSU '17, this workshop hopes to introduce new hackers to the basics of using git with GitHub.

Markdown

• Mastering Markdown - GitHub guide to mastering GitHub flavoured markdown

Workshops

Resources for running workshops and workshops that other campus experts have run themselves or that may be useful to others.

Tips

• Speaking.io - a cool website with some good tips on giving talks, focused on tech talks mostly
• The Art of Slide Design - Melinda Seckington, talk on the fundamentals of good slide design for pleasant and effective transfer of information.

Teaching

• github/training-utils - A series of Bash and ZShell scripts useful when teaching about git and GitHub (+ bonus list of useful apps)
• codesandbox - Online web application editor (react, vue), useful when running a react/vue or other framework type workshop.
• Glitch - Online HTML/JS/CSS editor and viewer, very useful when doing HTMl / web based workshops. Also hosts the static site at project-name.glitch.me. Bonus, runs node.js so it can also be used to run an api workshop if the backend is written in node.js.

Slide Resources

• FsReveal - FsReveal allows you to write beautiful slides in Markdown and brings F# to the reveal.js web presentation framework.
• Remark - A simple, in-browser, markdown-driven slideshow tool targeted at people who know their way around HTML and CSS.
• reveal-md - Write reveal.js slides as a single markdown file, and use markdown's html fallback to add more complicated markup and set reveal-specific configuration (like fragments).

Writing

Resources for writing and maintaining technical documentation

Visualisation

• Apiary - Powerful API Design Stack. Built for Developers.
• Swagger - Swagger is a powerful open source framework backed by a large ecosystem of tools that helps design, build, document, and consume RESTful APIs.

Tools

• nanoc - Nanoc is a static-site generator, fit for building anything from a small personal blog to a large corporate website. (used by GitHub on their own docs)
• Sphinx - Sphinx is a tool that makes it easy to create intelligent and beautiful documentation, originally created for the Python documentation.
• Daux - Daux is an documentation generator that uses a simple folder structure and Markdown files to create custom documentation on the fly.
• 🚩 mdpdf - mdpdf is a tool for generating stylable pdfs from markdown.

Content Guides

Communication and writing style

• MailChimp - The style guide was created for MailChimp employees
• 18f - How to plan, write, and manage content at 18F.
• Digital Ocean - DigitalOcean's Writing Guidelines
• SendGrid - How To Write Technical Blog Posts

Open Source

Find Projects

• Up For Grabs - List of projects which have curated tasks specifically for new contributors.
• issuehub.io - Contribute to Open Source. Search issue labels to find the right project for you!
• FIRST TIMERS ONLY - Friendly Open Source projects should reserve specific issues for newbies.
• Your First PR - Your First PR helps you get started contributing to Open Source by showcasing great starter issues on GitHub and elsewhere.
• Awesome First PR Opportunities - A list of awesome beginners-friendly projects.
• Codetriange - Help out your favorite open source projects and become a better developer while doing it.
• Pull Request Roulette - Pull requests (or PRs) submitted for review
• 24 Pull Requests - Contribute to projects for 24 days leading up to christmas
• WebCompat - Bug reporting for the internet

Community

Management

• Curriculum for the Atom Community Manager Apprenticeship project

Contribute

Contributions welcome! Read the contribution guidelines first.

License

To the extent possible under law, Joe Nash has waived all copyright and related or neighboring rights to this work.