Skip to content
The Computer Science Field Guide is an online interactive resource/textbook for high school students learning about computer science, developed at the University of Canterbury in New Zealand.
Branch: develop
Clone or download
Pull request Compare This branch is 343 commits ahead, 2216 commits behind uccser:develop.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
docs
files
generator
images
interactives
output
text
.codeclimate.yml
.editorconfig
.gitattributes
.gitignore
.travis.yml
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE.md
README.md
generateguide.py
guide-settings.conf
requirements-print.txt
requirements.txt

README.md

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 www.csfieldguide.org.nz. 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.

Requires

  • Python 3.4+

Installation

Download the latest release from the GitHub releases page, or clone the repository for the latest development version.

The required dependencies are listed within requirements.txt and can be installed using the Python package pip (see how to do this here), or can be manually installed to suit your environment.

Usage

Run generateguide.py with Python 3. This will produce an student version of the CSFG in English. Details about optional parameters are found within the usage documentation.

Bugs and feature requests

Have a bug or a feature request? Please first search for existing and closed issues in our issue tracker. If your problem or idea is not addressed yet, please open a new issue.

Contributing

We would love your help to make this guide the best it can be! Please read our contribution guide to get started. Possible areas for contributions include:

  • Suggesting a text edit for a typo, grammar correction, or just clearing up a point.
  • Add a translation for a chapter or interactive.
  • Add a new or replacement image for a chapter.
  • Modify text and create their own version of the CSFG.
  • Add or modify an interactive for the guide.

Documentation

Documentation for this project is stored in the documentation folder.

License

The Computer Science Field Guide uses a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0) license. Read the license file for more details.

Contact

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

You can’t perform that action at this time.