An online interactive resource/textbook for high school students learning about computer science.
Clone or download
JackMorganNZ Merge pull request #719 from uccser/blockquote
Add blockquote in introduction
Latest commit c289179 Sep 19, 2018
Failed to load latest commit information.
.github Updating contributing guide, ISSUE template and PR template Jun 12, 2017
csfieldguide Add custom template for blockquote Sep 17, 2018
docs Update documentation Sep 13, 2018
generator Merge branch 'develop' into content-restructure Jun 5, 2018
infrastructure Add local JS module and require in interactive Jul 21, 2018
requirements Update verto from 0.8.0 to 0.9.0 Sep 14, 2018
subtitles Added english subtitles for youtube videos. Jun 22, 2017
text/en Delete unused text files Jul 1, 2018
.arnold.yaml Add locale file and Arnold translation config Aug 21, 2018
.coveragerc Update coverage file to include search module Jul 4, 2018
.dockerignore Adding missing new lines to end of files Nov 28, 2017
.editorconfig Changed language settings file to use YAML syntax (build fails) Jun 28, 2016
.gitattributes Update .gitattributes to ignore third-party & docs folders (fixes #353) Jun 6, 2016
.gitignore Update .gitignore Jul 19, 2018
.pyup.yml Set pyup to use develop branch Jul 1, 2018
.travis.yml Update Travis CI config file Sep 12, 2018
Dockerfile Updated dockerfile to use latest uccser docker image Mar 15, 2018
Dockerfile-local Load libraries from NPM (#678) Jul 16, 2018
LICENCE Fixes to docs re incorrect spelling of licence Feb 27, 2018
LICENCE-CONTENT Finished writing up new interactives docs Feb 16, 2018
LICENCE-THIRD-PARTY Fix typo in licence file Jul 23, 2018 Updating licences Jun 13, 2017
csfg Update 'build' command to only build images and not clean Aug 1, 2018
docker-compose.yml (WIP - Moving machines) Jul 19, 2018 Add ability to list authors in sidebar Oct 18, 2016
setup.cfg PEP8 fixes Jun 25, 2018

Computer Science Field Guide

Build Status

The Computer Science Field Guide (CSFG) is an online interactive resource for high school students learning about computer science, developed at the University of Canterbury in New Zealand. The latest HTML release of the Computer Science Field Guide can be viewed at This repository aims to be the source for all data associated with the CSFG, and also allows users to suggest improvements or create their own version.

Project Philosophy

The CSFG aims to be an document used for teaching Computer Science all over the world in many different languages. After using an internal system for creating the guide (from 2012 to 2015), we have moved to a custom open source system. All areas of the project, from chapter text to website design, are now available for all. We want this project to be as accessible as possible to our many user groups, which includes students, teachers and educators, and developers.


Documentation for this project can be found on ReadTheDocs, and can also be built from the documentation source within the docs/ directory.


We would love your help to make this guide the best it can be! Please read our contribution guide to get started.


The content of this project itself is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license (LICENSE-CONTENT file). This license applies to the following contents of this project:

  • Markdown files located within the csfieldguide/chapters/content/ directory.
  • Images located within the csfieldguide/static/img/ directory.

Third-party libraries used in this project have their license's listed within the LICENSE-THIRD-PARTY file, with a full copy of the license available within the third-party-licenses directory. If a source file of a third-party library or system is stored within this repository, then a copyright notice should be present at the top of the file.

The rest of the project, which is the underlying source code used to manage and display this content, is licensed under the MIT license (LICENSE file).


This repository is currently primarily managed by Jack Morgan, with Hayley van Waas and Tim Bell as backup administrators.