This repository contains comprehensive training modules for getting started with open source software development. The training modules are provided as interactive Jupyter Notebooks that you can read like a book or run interactively in a Jupyter session.

Module	Title	Description	Static	Interactive
00	History and Philosophy of Open Source	The origins of free software, Richard Stallman's printer story, software licensing types, and the philosophy behind open source
01	Open Source Licensing	Overview of open source licenses, their terms, compatibility, and how to choose the right license for your project
02	Git Basics	Fundamental Git operations, repositories, and version control workflows
03	Git Workflows: Issues, Forks, and Pull Requests	Collaborative workflows on GitHub including issues, forks, and pull requests
03a	GitHub Project Management	Using GitHub labels, milestones, Projects v2 boards, issue search, and task chunking to organize open source work
04	Testing Code: What, Why and How To	Comprehensive guide to software testing including unit, integration, and acceptance testing
05	Continuous Integration and Continuous Delivery	CI/CD concepts, GitHub Actions, and automated testing workflows
06	Code Review	Best practices for conducting effective code reviews and maintaining code quality
07	Governance Foundations	Open source governance models, foundations, and decision-making processes		-
08	Open Source Lifecycle and Sustainability	Understanding OSS project lifecycle, sustainability evaluation, and ecosystem dynamics
09	Security Best Practices	Supply chain security, SBOMs, attestations, Semgrep, SLSA, and Gittuf for OSS projects

All training notebooks require the jupyter Python package. Some may require additional packages (such as bash_kernel). See the intro section of each notebook for details.

pip install jupyter jupyterlab bash_kernel
python -m bash_kernel.install

To run the same notebook checks used in CI and pre-commit:

pip install -r requirements-notebook-tests.txt
pre-commit install
pre-commit run --all-files
#Notebook tests will run locally and return errors or passing state
Execute training notebooks...............................................Passed

The notebooks can also be loaded using Google Colab, a hosted Jupyter notebook service from Google. To run these notebooks using Colab:

1. Go to colab.research.google.com (you may need to log in with your Google account)
2. Click on File → Open Notebook
3. Go to the GitHub tab and paste the repo URL: https://github.com/gt-ospo/oss-training.git
4. Click the search icon and select the notebook you wish to run
5. Use the Runtime tab to execute the notebook

We welcome contributions to improve these training materials! Please read our Contributing Guidelines for details on how to submit improvements, report issues, or suggest new content. All contributors are expected to follow our Code of Conduct to maintain a welcoming and inclusive environment.

This project is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. See the LICENSE file for details.

The Georgia Tech Open Source Program Office (GT OSPO) promotes and supports open source software development, education, and research within the Georgia Tech community and beyond.