Summary and Setup
Have you ever been handed a piece of legacy code to use or maintain, only to find that there is little to no documentation? How long have you spent trying to decompose and understand its functionality?
In this lesson, students will learn about the different types of software documentation, as well as how to write it well and tools to enable better documentation habits.
Prerequisites
- Basic understanding of git
- git (installed locally)
- Basic understanding of python
- Python 3.10+ with pip (installed locally)
- Text editor
- GitHub account
- Copy of INTERSECT Practice Template
CodeRefinery has useful information about how to get started with git, from installation to usage.
Most Linux and Windows machines come with a default version of Python. If your machine does not have Python already installed or the default version is too old, please use the following how-to: