javascript-koans-esl

This is mrdavidlaing's JavaScript Koans, but with simple English. The vague Buddhist language in the original has been replaced with simple English. Set-up instructions are also added for complete beginners.

Javascript koans is to teach you JavaScript programming through testing. When you first run the koans, you will be given a 'runtime error' and a 'stack trace' indicating where the error occured.

Your goal is to find and fix the error.

Through exploring the code and fixing the errors, you will learn new things about the JavaScript language and functional programming.

What are koans?

A koan is a riddle or puzzle that Zen Buddhists use during meditation to help them unravel greater truths about the world and about themselves.

source

Setting Up

Download Using Git

If you know git:

git clone https://github.com/yanarchy/javascript-koans-esl.git

Download Without Git

If you do not know git, please download the zip and unzip on your computer.

Open in Text Editor

If you do not have a text editor for JavaScript, I highly recommend downloading and installing Sublime Text or Atom.

Open this javascript-koans-esl project folder in your text editor.

How to Start

1. Open the KoansRunner.html file in the browser (for example, Chrome or Firefox).

2. The first error will be in koans/AboutExpects.js.

3. Fix the first test in the koans/AboutExpects.js file and save it.

4. Refresh the KoansRunner.html page you have open in the browser.

5. Repeat! Fix a test, save the file, refresh the browser. Tests will turn green when they are correct.

Tips

• Do not think too much about each problem--they are simple, especially in the beginning.
• Are you really stuck on something? You can disable a test by adding an 'x' to the beginning of 'it(...)'. If you do this, the KoansRunner will skip this particular test and go on to the next. Remember to come back to the tests that you disable!

  xit('should be disabled', function () {
    // This is an example
  });

• Don't be afraid to Google
• Don't be afraid to make mistakes

Other Information

Is there anything that needs to be explained in simpler English? Let me know.

The test runner used is Jasmine with a customized report viewer. Understanding Jasmine is not important for finishing this.