This page lists updates to the Computer Science Field Guide. All notable changes to this project will be documented in this file.

• What numbering system do we use?

We base our numbering system from the guidelines at Semantic Versioning 2.0.0, however since our project started before it was migrated to GitHub, the first open source release is being labeled as 2.0.0.

Given a version number MAJOR.MINOR.HOTFIX:

• MAJOR version change when major text modifications are made (for example: new chapter, changing how a curriculum guide teaches a subject).
• MINOR version change when content or functionality is added or updated (for example: new videos, new activities, large number of text (typo/grammar) fixes).
• HOTFIX version change when bug hotfixes are made (for example: fixing a typo, fixing a bug in an interactive).
• A pre-release version is denoted by appending a hyphen and the alpha label followed by the pre-release version.

We have listed major changes for each release below.

Release date: 7th March 2018

Changelog:

• Update Artificial Intelligence chapter to use shorter introduction video.
• Update Unicode Binary interactive to display UTF mode.
• Bugfixes for Sorting/Searching Boxes interactives.
• Grammar/spelling fixes for HCI chapter.
• Correct quote by Mike Fellows in Introduction chapter.

Release date: 13th February 2018

Changelog:

• Add Huffman coding section to compression chapter with Huffman Tree generator interactive.
• Add Viola-Jones face detection interactive.
• Add 2018 NCEA curriculum guides.
• Update Pixel Viewer interactive with threshold, blur, and edge detection modes for computer vision chapter. #32 #388
• Fix bug in Base Calculator interactive where computed value displayed incorrectly. #558
• Update Microsoft logo. #527
• Add videos to Formal Languages chapter #518
• Fix capitalisation of title of complexity and tractability chapter. #513
• Migrate Mathjax to new CDN. #482

Release date: 18th October 2017

Changelog:

• Add Bin Packing interactice. #490
• Correct Two's Complement text. #503
• Remove contributor names from changelogs.
• Update JPEG interactive. #488
• Remove search as it focuses on outdated releases. #508
• Correctly detect text size for Unicode Length interactive. #501
• Fix broken link to CSFG in Network Protocols chapter. #504
• Fix typo in section 2.1.3. #507

Release date: 3rd September 2017

Changelog:

• Fix broken links to NCEA curriculum guides. #483
• Fix broken link to research paper. #484
• Fix panels showing 'None' as title. #485

Release date: 2nd September 2017

Notable changes:

This release adds a JPEG compression interactive, along with many bug fixes, corrections, and.

The version numbering scheme now does not start with the v character (so v2.9.1 is 2.9.1). This to make the numbering consistent with our other projects (CS Unplugged and cs4teachers).

Changelog:

• Update Delay Analyser reset button to avoid accidental resets. #413
• Clean up homepage for the NCEA Curriculum Guides. #358
• Replace cosine image. #73
• Fix bug in detecting defined permissions of files. #73
• Fix Washing Machine interactive in Formal Languages chapter. #411
• Correct spelling of aesthetics and add glossary definition. #405
• Fix rendering of glossary definition headings.
• Fix PBM image data. #412
• Fix link error in HCI chapter. #410
• Add missing NCEA guides files. #472
• Update binary-cards interactive to handle a higher number of cards. #407
• Add ability to hide pixel colours in pixel value interactive. #476

Release date: 20th February 2017

Notable changes:

This release fixes a bug in the Computer Graphics chapter where some links to the 2D Arrow Manipulation interactives were broken due to an incorrect regex.

Changelog:

Release date: 27th January 2017

Notable changes:

This release adds an introductory video for the Complexity and Tractability chapter, updated text for Graphics Transformations section of the Computer Graphics chapter, as well as updated versions of the 2D Arrow Manipulation and FSA interactives.

Changelog:

• Add introductory video to Complexity and Tractability chapter.
• Rewrite Graphics Transformations section of Computer Graphics chapter. #402
• Rewrite 2D Arrow Manipulation interactives. #372 #373
• Add list of authors in the sidebar of chapter page. #396
• Update FSA interactives. #45 #46 #47 #48
• Update APCSP framework. #399

Release date: 21st October 2016

Changelog:

• Update introduction chapter. #231
• Add notice of changes to AP-CSP curriculum in Fall 2016 release.
• Skip parsing # characters at start of Markdown links.

Release date: 19th October 2016

Notable changes:

This release adds an introductory video for the Human Computer Interaction chapter, plus a draft of guides for mapping the Computer Science Field Guide to the AP CSP curriculum.

Changelog:

• Add introductory video to Human Computer Interaction chapter.
• Add draft of guides for the AP CSP curriculum. #316
• Update and fix issues in high-score-boxes interactive. #390 #391 #393
• Add subtraction command to mips-simulator interactive. The interactive can now handle subtraction down to zero. #382
• Update sponsor information in footer.
• Improve the visibilty of warning panels. #389
• Fix typos in Formal Languages chapter. #385
• Update 404 page to avoid updating after each release. #394
• Remove duplicate introduction to teacher guide. #213
• Add link to article on representing a 1 bit image. #376
• Fix broken link to contributors page in footer. #383
• Replace broken link to Eliza chatterbot. #384
• Fix footer link colour in teacher version. #395

Release date: 5th September 2016

Notable changes:

• Fixed broken link in footer to contributors page.

A full list of changes in this version is available on GitHub.

Release date: 23rd August 2016

Notable changes:

• New video: Formal Languages now has an introductory video.
• New interactive: The hexadecimal background colour interactive allows a user to change the background colour of the page.
• New curriculum guide: A guide for NCEA Artificial Intelligence: Turing Test has been added.
• Updated interactives: The box translation and box rotation interactives are now open source and have been given a new look and made mobile friendly.
• Generation improvements: Basic translation support. Settings are now specific to each language, and contain the translation text.
• Website improvements: Added help guide for WebGL interactives.
• Also includes bug fixes to interactives, new links to supporting videos, and various text corrections from our staff and contributors.

A full list of changes in this version is available on GitHub.

Release date: 14th July 2016

Notable changes:

• Fixed issue on Human Computer Interaction chapter where duplicate library was causing several UI elements to not behave correctly.

Release date: 16th June 2016

Notable changes:

• New feature: PDF output - A downloadable PDF of both student and teacher versions is now available from the homepage. The PDF also functions well as an ebook, with functional links to headings, glossary entries, interactives, and online resources.
• New feature: Printer friendly webpages - When printing a page of the CSFG through a browser, the page displays in a printer friendly manner by hiding navigational panels, opening all panels, and providing extra links to online resources.
• New interactive: The binary cards interactive emulates the Binary Cards CS Unplugged activity, used to teach binary numbers.
• New interactive: The high score boxes interactive was developed to give an example of searching boxes to find a maximum value to the student.
• New interactive: The action menu interactive is a small dropdown menu with one option that has severe consequences, but no confirmation screen if the user selects that option (used to demonstrate a key HCI concept).
• Updated interactive: The trainsylvania interactive (and supporting images/files) have been given a fresh coat of colour and a new station name.
• Updated interactive: The trainsylvania planner interactive is used alongside the trainsylvania interactive, and allows the user to input a path of train trips to see the resulting destination.
• Updated interactive: The base calculator allows a student to calculate a number, using a specific number base (binary, hexadecimal, etc).
• Updated interactive: The big number calculator allows a student to perform calculations with very large numbers/results.
• Website improvements: Redesigned homepage and footer with useful links and a splash of colour. Math equations are now line wrapped, and MathJax is loaded from a CDN. Images can now have text wrapped around them on a page.
• Generation improvements: Improvements to internal link creation (glossary links in particular). Separated dependency installation from generation script (see documentation for how to install and run generation script).
• Project improvements: Added documentation for contributing to and developing this project, including a code of conduct.

A full list of changes in this version is available on GitHub.

Release date: 13th May 2016

Notable changes:

• The Data Representation chapter has been rewritten and reorganised to be easier to follow, and three NCEA assessment guides have been written for students aiming for merit/excellence:

The chapter and assessment guides have been rewritten to take account of new feedback from the marking process and our own observations of student work.

As part of the rewrite of the Data Representation chapter, the following interactives were developed:

• New interactive: The unicode binary interactive displays the binary for a given character (or character by decimal number) dynamically with different encodings.
• New interactive: The unicode character interactive displays the character for a given decimal value.
• New interactive: The unicode length interactive displays the length (in bits) of text encoded using different encodings.
• Updated interactive: The colour matcher interactive has been redesigned to display values in binary, plus allow students to see and edit the bit values. The interface has also been restructured for readability and ease of use.

The old version of the Data Representation chapter can be found here.

• Website improvements: A new image previewer was implemented, along with bugfixes to iFrame and panel rendering.
• Generation improvements: The Markdown parser has been replaced due to existing parsing issues. The new parser also gives us a large performance boost. A text box tag has also been added to highlight important text.

A full list of changes in this version is available on GitHub.

Release date: 29th April 2016

Notable changes:

• Fixed version numbering system to allow hotfix changes

A full list of changes in this version is available on GitHub.

Release date: 29th April 2016

Notable changes:

• Large number of typo, grammar, link, and math syntax fixes and also content corrections by contributors.
• New interactive: Added GTIN-13 checksum calculator interactive for calculating the last digit for a GTIN-13 barcode.
• Updated interactive: The regular expression search interactive has been updated and added to the repository.
• Updated interactive: The image bit comparer interactive has been updated and added to the repository. It also has a changing bits mode which allows the user to modify the number of bits for storing each colour.
• Added XKCD mouseover text (similar behaviour to website).
• Added feedback modal to allow developers to directly post issues to GitHub.
• Added encoding for HTML entities to stop certain characters not appearing correctly in browsers.
• Added summary of output at end of generation script.
• Added message for developers to contribute in the web console.

A full list of changes in this version is available on GitHub.

Release date: 10th March 2016

Notable changes:

• Readability improvements to text within many chapters (grammer issues/typos) and to the Python scripts within the Algorithms chapter.
• Updated interactive: The RSA encryption and decryption interactives within Encryption have been updated and added to the repository.
• Updated interactive: The searching algorithms interactive within Algorithms have been updated and added to the repository.
• Updated interactive: The word filter interactive within Formal Languages have been updated and added to the repository.
• Updated interactives: Both the MIPS assembler and MIPS simulator were made open source by the original author, and we were given permission to incorporate our repository, and have been added to Programming Languages.
• A list of all interactives are now available on the interactives page.

A full list of changes in this version is available on GitHub.

Release date: 19th February 2016

Notable changes:

A full list of changes in this version is available on GitHub.

Release date: 12th February 2016

Notable changes:

• Fixed many broken links and typos from 2.0.0
• Added calculator interactives to Introduction
• Added RSA key generator to Encryption
• Rewritten Braille Section in Data Representation

A full list of changes in this version is available on GitHub.

Release date: 5th February 2016

Notable changes:

• First open source release
• Produces both student and teacher versions
• Produces landing page for selecting language
• Added new NCEA curriculum guides on Encryption and Human Computer Interaction

A full list of changes in this version is available on GitHub.

Comments: The first major step in releasing a open source version of the Computer Science Field Guide. While some content (most notably interactives) have yet to be added to the new system, we are releasing this update for New Zealand teachers to use at the beginning of their academic year. For any interactives that are missing, links are in place to the older interactives.

Release date: 29th January 2016