Document and Pass

These are a series of javascript exercises intended to help you learn how to document and test functions. They start very simply, but get more involved as you progress through them.

Set-Up

Before you start you should have a few things installed on your machine:

1. NPM. To check if you have NPM, type npm --version in a terminal. If you get back Command 'npm' not found, but can be installed with:, do NOT follow the instructions in the terminal to install with apt-get (this causes permission issues). Instead, install NPM/Node with NVM by following the instructions here.
2. Jasmine. Jasmine is a testing framework for Javascript. Type jasmine -v to check for it. If you need to install it, type npm install -g jasmine to do so.
3. Clone this repo
4. npm install
5. happy coding!

Studying

Exercises are grouped by difficulty level (0, 1, 2, 3). Each exercise includes 4 files:

1. a markdown file with a description of the task
2. an empty (or mostly empty) index.js, this is where you will write your code and documentation
3. a set of tests in index.spec.js
4. a file called report.txt, test results will be written to this file by npm run test

Documenting

Each index.js contains an empty function with an empty doc string. Before writing any code take some time to study the test cases and write the docstring. Understanding and describing the function's behavior before writing any code will set you up for success. Be sure to include:

1. A full description of the function's behavior (ie. test cases, not the code you write inside the function)
2. A complete list of parameters, including their types and a short description
3. The return value, including it's type and a short description
4. An example use case

To see what this looks like, check out 0-hello-world/index.js. To publish your jsdoc comments to the main README open this directory in CLI and enter npm run document.

Passing

To complete the exercise go to the exercise directory with cd exercise-name in a terminal and run jasmine index.spec.js. This should find and run the test file and show you the output. Upon first running the tests you will find that the tests fail: this is by design! Your task is to open up the javascript file and write the code needed to get all of the tests to pass.

The first exercise, 0-hello-world will walk you through the process in more depth.