/es6-workshop

A very hands on :open_hands: workshop :computer: about ES6 and beyond.

Primary LanguageJavaScriptMIT LicenseMIT

ES6-Workshop

slides-badge chat-badge Build Status Dependencies MIT License All Contributors

PRs Welcome Donate Code of Conduct Watch on GitHub Star on GitHub Tweet

Sponsor

Welcome

Welcome to this ES6 workshop. Our goal is to help everyone make strides towards learning the newest ES6 syntax, and how to use the latest constructs in JavaScript.

This repo is meant to be used in parallel with a lecture style presentation of the new features.

Thanks

Special thanks to Aaron Frost and Axel Rauschmayer for creating the original repo from which this is forked.

Your Goal

This repo is full of failing tests. The only way to get them to pass it by using your newly acquired knowledge of ES6 and all of the new features that are part of this latest release. For each test, you will need to write/rewrite to code using the latest ES6 syntax. Once all of your tests pass, you will want to move onto the next section.

By the time that the workshop is over (time permitting), all of your tests will be running and passing.

System Requirements

  • git
  • Node (at least version 6)
  • yarn (at least version 0.17.0)

Setup

You will need to start by cloning this repo, then you'll run a simple setup script which will install all the dependencies and validate that you're ready to go. From your terminal, type:

git clone https://github.com/kentcdodds/es6-workshop.git
cd es6-workshop
yarn run setup
yarn run autofill-email YOUR_EMAIL@DOMAIN.COM
git commit -am "setup"

Replace YOUR_EMAIL@DOMAIN.COM with your email address

If this finishes without issues, great 👏! However, if you have problems, please file an issue on this repo here.

Note on yarn

If you don't have yarn installed and don't want to use it for some reason, you can use npm as well. Instead of yarn run setup, run node ./scripts/install && npm run validate and enjoy waiting (and hopefully things don't break for you). May be a good idea to still run node ./scripts/verify to verify you have the right version of other things too.

How To Run Tests

Once you have everything installed, you are ready to run some tests. There are two directories with tests in them: exercises and exercises-final. The exercises-final directory is like a cheat sheet. All of the tests contain the required ES6 code to make the tests pass. You will need to edit the tests in the exercises directory, and make the tests pass.

To run the tests, in your terminal run:

yarn test

To run a specific test file, in your terminal run:

yarn test -- exercises/01_block-scoping.test.js

If you want the tests to continue running as you make changes, run:

yarn run test:watch

This will start jest in its interactive watch mode (learn more). If you see a bunch of failures, make sure you're in "only changed" mode by clicking the o key. There should not be any tests run at this point. Your job is to go into each test file in exercises and make the tests pass. As you make changes, jest will run the file's tests. Once you have written the required ES6 code, the tests will pass, and you can move on.

Also, during watch mode you can press the p key to filter for only the test file you want to run. You can even press the t key to filter for only the tests you want to run (by their test name). Note, that for these to work, you need to run all the tests first. Hit the a key to do that.

Note: You may prefer to run the test:changed script which will run the tests only once. This will allow you to avoid the "learning crutch" of immediate feedback that you get from the watch mode. But it's up to you!

Contributing

If you have any questions, let me know.

If you use this workshop, please Pull Request this README with a link to your event.

If you want to edit/update anything in the exercises, please make all changes in the templates directory. We're using split-guide, so the exercises and exercises-final directories are generated.

Events

Contributors

Thanks goes to these wonderful people (emoji key):


Aaron Frost

💻 📖 📢 ⚠️

Axel Rauschmayer

📢

Kent C. Dodds

💻 📖 🚇 👀 📢 ⚠️

Jim Cummins

📖 ⚠️

Lindsey

📖

Marius Butuc

💻

Carlos Ortega

📖

Ryan Braganza

💻

Emrah Mehmedov

💻 ⚠️

Arijit Layek

💻

Dhruv Mishra

💻

Bobby White

⚠️

Ben Ilegbodu

📖 ⚠️

Thomas Greenhalgh

💻

Aaron Ang

💻 📖

Daniela Yassuda

💻

This project follows the all-contributors specification. Contributions of any kind welcome!

LICENSE

MIT