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	Interacting with Git and GitHub	Introduction to Git concepts, branching, and merging fundamentals
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
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	OSS Project Best Practices	Tips for successful open source projects and lessons from established projects		-
09	Open Source Lifecycle and Sustainability	Understanding OSS project lifecycle, sustainability evaluation, and ecosystem dynamics

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

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.