Description
Getting Started
If you have not yet contributed to concept exercises before, this task requires some upfront reading to acquire the necessary background knowledge.
Here you can read about what Concept Exercises are and how they are structured:
If you have not done so yet, it is probably also helpful to do a couple of "Learning Exercises" (this is how they are called on the site) yourself. You can also look at the code of an existing concept exercise like bird-watcher (concept for-loops) for reference.
See the documentation above (general documentation), as well as How to implement a Concept Exercise in JavaScript.
Also be aware of these general guidelines.
Goal
The goal here is to create a new concept exercise to teach randomness (random number generation).
The concept needs to be written from scratch, the exercise can be ported from another track (see details below).
Concepts
The following concept needs to be created. You can use the introduction.md file of the concept also as introduction.md file of the exercise. No need to create different content at this point. Additionally, if you want to save some time it is ok to not have an extensive about.md for now. It can also be mainly the introduction.md content, maybe with some additions you would like to make.
randomness
Learning Objectives
In the concepts the student should learn about the following topics and then practice them in the concept exercise.
- how to create pseudo random numbers with
Math.random - how to create pseudo random integers
- the seed is selected automatically and cannot be influenced by the user
- when and how to create cryptographically secure random numbers (web and node), should not be part of the exercise but would be good to mention in the concept to raise security awareness
It would be good to include a link to an explanation why randomness is hard/what pseudo random numbers are.
Out of Scope
- details of pseudo random number generation in general
- discussing the different algorithms
As always, the concept should mainly focus on the JavaScript specific parts.
Prerequisites
numbers
Other prerequisites should be added as needed to solve the specific exercise.
Exercise Idea
Elixir "Captain's Log" Exercise could serve as template.
In case you port that exercise, it is probably a good idea to omit the last task (does not belong to this concept) and switching task 1 and 2 because in JavaScript, task 2 is easier.
Resources
Here some links that might be helpful as a starting point and/or for the links section of the concept:
- https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/random
- https://en.wikipedia.org/wiki/Pseudorandom_number_generator
How to proceed
- First accept this issue by saying "I'd like to work on this" (no need to wait for a response, just go ahead).
- Use this issue to discuss any questions you have, what should be included in the content and what not and to collect more reference material.
- Create a PR and set "exercism/javascript" as reviewers. Additionally you can write in #maintaining-javascript on Slack that your PR is ready for review. Once you incorporated any critical feedback that the reviewer might give you and the PR is approved, it will be merged by a maintainer.