Overflow Handbook
What is this?
This handbook aims to serve as a guide throughout your journey as a committee member of Overflow. It contains details on how the club is ran, important things you should keep note of, as well as past proposals.
Regardless of what your role might be, be it as the President or a Tech Lead, this handbook should serve a useful resource in performing your role to it's best.
Tip
If you're not a committee member, this handbook should give you a rough idea of the things Overflow handles.
In this handbook you will find various guides and resources on the various duties a committee member will have to perform. This includes but is not limited to; preparing workshop sessions, bootcamps, and the various events that Overflow hosts and prepares throughout the year.
This handbook is heavily inspired by the GitLab Handbook, which you can view here.
Contributing
All contributions to the handbook are welcome, no matter your role. In the section on resources, you will find a more detailed guide on what should be included here.
Contributions can be made as a GitHub PR, and should follow the general guidelines detailed here.
Running remotely
To get started with contributing to the handbook, to make things easier, you can consider using a hosted service like GitHub Codespaces or GitPod.
Running locally
Alternatively, if you'd like to make changes locally, follow the steps below:
- Clone the repo:
git clone https://github.com/np-overflow/handbook
- Choose your preferred path: Docker or running manually.
Running locally using Docker
- Install dependencies:
make build
- Start the dev server:
make dev
Running locally manually
- Ensure that a version of Python is installed.
- Install
mkdocs
globally:pip install -U mkdocs
- Install dependencies:
pip install -r requirements.txt
- Start the dev server:
mkdocs serve
Created: August 23, 2024