# Changelog¶

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

Note

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.

## 3.0.2¶

Changelog:

• Add interactive to demonstrate limitations of short term memory. #144
• Add second short term memory interactive. #1090
• Fix broken links to old interactives in the computer graphics chapter.
• Update about page and introduction chapter. #1082
• Improve consistency in chapter section beginnings. #1065
• Align and resize homepage logos. #1050
• Center homepage icons on Firefox mobile. #1066
• Add link to Vox video on how snapchat filters work in the computer vision chapter. #367
• Reduce length of search bar on mobile. #1080
• Dependency updates:
• Update django-modeltranslation from 0.13.1 to 0.13.2.
• Update Pillow from 6.0.0 to 6.1.0.
• Update python-bidi from 0.4.0 to 0.4.2.

## 3.0.1¶

Changelog:

• Fix bug where binary cards were not flipping back to white on Chrome. #1056
• Add background to navigation dropdown on mobile. #1054
• Add option to reshuffle weights in sorting algorithms interactive. #1070
• Add link to curriculum guides in useful links. #1052
• Fix several content errors. #1044
• Remove broken links that have no replacement link.
• Improve formatting and correct spelling errors.
• Correct sentence that states there are 0.6 kilometers in a mile.
• Fix formatting issues, add glossary links and a glossary term for bozo search. #1060
• Floating elements no longer overlap the subsection divider. #1059
• Add a redirect for the old homepage URL to the new homepage URL. #1058
• Correct spelling and formatting in the changelog. #1037
• Add a temporary fix for deploying static files. #1046

## 3.0.0¶

Changelog:

• Rebuild the CS Field Guide website to use an open source Django system based off CS Unplugged (see the GitHub milestone). Major features include:
• Greatly improved translation features.
• Allowing student and teacher pages to use the same URLs (switch between modes available in page footer).
• Search functionality for English chapters.
• Improve chapter content:
• Chapter sections are now split across pages for better readability.
• General content, grammar, and spelling fixes.
• View glossary definitions within a page.
• Introduce new chapter sections:
• ‘User experience’ by Hayley van Waas for the Human Computer Interaction chapter.
• ‘General purpose compression’ by Hayley van Waas for the Coding - Compression chapter.
• Improve interactives:
• Introduce automated thumbnail generator.
• Introduce many ‘uninteractives’ - allowing image text to be translated.
• Update existing interactives for better accessibility.
• Introduce new interactives:
• Algorithm Timer
• Braille Alphabet
• City Trip
• Dictionary Compression
• Dot combinations
• LZSS compression
• LZW Compression
• Pixel Grid
• Remove obsolete interactives:
• MD5-hash
• ncea-guide-selector
• ziv-lempel-coding
• Redesign homepage.
• Update documentation and contributing guides.
• Update contributors page.
• Improve licencing structure to make it easier to find and navigate on GitHub.
• Rename ‘2D Arrow Manipulations’ interactive to ‘2D Shape Manipulations’.
• Introduce initial German and Spanish translations.

## 2.12.2¶

Changelog:

• Add optional parameters to Pixel Viewer interactive to specific starting image, hide pixel fill, and hide menu. #630
• Grammar/spelling fixes for Data Representation and Compression Coding chapters. #626

This release is archived for viewing here

The teacher version is archived for viewing here

## 2.12.1¶

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.

## 2.12.0¶

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

## 2.11.0¶

Changelog:

• Add Bin Packing interactive. #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

## 2.10.1¶

Changelog:

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

## 2.10.0¶

Notable changes:

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

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
• Add video subtitle files.
• Clean up homepage for the NCEA Curriculum Guides. #358
• Replace cosine image. #73
• Fix bug in detecting defined permissions of files. #73
• Add Google Analytic skit videos to HCI chapter. #247
• 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
• Fix link to private YouTube video on packets. #408
• Update binary-cards interactive to handle a higher number of cards. #407
• Add ability to hide pixel colours in pixel value interactive. #476

## 2.9.1¶

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:

## 2.9.0¶

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
• Add NFA guesser interactive.
• Update APCSP framework. #399

## 2.8.1¶

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.

## 2.8.0¶

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 positioning of table of contents sidebar. #387
• 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

## 2.7.1¶

Notable changes:

• Fixed broken link in footer to contributors page.

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

## 2.7.0¶

Notable changes:

• New video: Formal Languages now has an introductory video.
• New interactive: The [hexadecimal background colour interactive interactives/hex-background-colour/index.html) 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

## 2.6.1¶

Notable changes:

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

## 2.6.0¶

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 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

## 2.5.0¶

Notable changes:

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 displays the binary for a given character (or character by decimal number) dynamically with different encodings.
• New interactive: The unicode character displays the character for a given decimal value.
• New interactive: The unicode length displays the length (in bits) of text encoded using different encodings.
• Updated interactive: The colour matcher 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

## 2.4.1¶

Notable changes:

• Fixed version numbering system to allow hotfix changes

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

## 2.4¶

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

## 2.3¶

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

## 2.2¶

Notable changes:

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

## 2.1¶

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

## 2.0¶

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.

## 2.0-alpha.2¶

• Release date: 25th January 2016

## 2.0-alpha.1¶

• Release date: 2nd December 2015

Comments: Released at CS4HS 2015.

## 1.?.?¶

• Release date: 3rd February 2015

Comments:

The last version of the CSFG before the open source version was adopted.

This release is archived for viewing here

The teacher version is archived for viewing here