Repository

The Button School repository is our internal workspace for developing course materials, building tools to support teaching and operations, and maintaining our public-facing websites. This documentation will help you understand how the repository is organized, how to get set up, and how to work effectively within it.

Who is this for?

This documentation is for anyone working with the Button School repository:

• Team members creating course content or documentation
• Contributors making changes to tools or websites
• New team members getting oriented with the codebase

What you’ll find here

This section covers:

• Getting Set Up — How to install and configure your development environment
• Repository Structure — Understanding the organization of directories and files
• Common Workflows — Git practices, content creation, and development processes
• Tools and Packages — Overview of available tools and when to use them
• Finding Things — Quick reference for locating content, documentation, and code

Related documentation

• For writing course content, see the Style Guide and Process sections
• For using Chalk, see the Chalk documentation
• For tools like Workbench and Blueprint, see their respective documentation sections