diff --git a/README.md b/README.md
index 7e90c241d..371029faf 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,8 @@
-> If you are following the HackYourFuture curriculum we recommend you to start with module 1: [HTML/CSS/GIT](https://github.com/HackYourFuture/HTML-CSS). To get a complete overview of the HackYourFuture curriculum first, click [here](https://github.com/HackYourFuture/curriculum).
+# DEPRECATED - JavaScript 2
+This module has been replace with the Browsers module, find it [here](https://github.com/HackYourFuture/Browsers)
-> Please help us improve and share your feedback! If you find better tutorials or links, please share them by [opening a pull request](https://github.com/HackYourFuture/JavaScript2/pulls).
-# Module #3 - JavaScript 2: DOM Manipulation (Frontend)
-
-
-
-If you were to ask a random person on the street the question "What is a browser?", you'll most likely get a variety of (incorrect) answers. For proof, check [this](https://www.youtube.com/watch?v=o4MwTvtyrUQ) out.
+```If you were to ask a random person on the street the question "What is a browser?", you'll most likely get a variety of (incorrect) answers. For proof, check [this](https://www.youtube.com/watch?v=o4MwTvtyrUQ) out.
You might be one of those people right now, but after this module no more. In **JavaScript2** you'll learn all about how to use JavaScript within the browser.
@@ -22,15 +18,46 @@ In order to successfully complete this module you will need to master the follow
## How to use this repository
+### Repository content
+
This repository consists of 3 essential parts:
-1. `Reading materials`: this document contains all the required theory you need to know _**while**_ you're coding. It's meant as both study material and as a reference to understand what you're doing.
-2. `Homework`: this document contains the instructions for each week's homework.
-3. `Lesson Plans`: this part is meant for teachers as a reference. However, as a student don't be shy to take a look at it as well!
+1. `README`: this document contains all the required theory you need to understand **while** working on the homework. It contains not only the right resources to learn about the concepts, but also lectures done by HackYourFuture teachers. This is the **first thing** you should start with every week
+2. `MAKEME`: this document contains the instructions for each week's homework. Start with the exercises rather quickly, so that you can ground the concepts you read about earlier.
+3. `LESSONPLAN`: this document is meant for teachers as a reference. However, as a student don't be shy to take a look at it as well!
+
+### How to study
+
+Let's say you are just starting out with the JavaScript2 module. This is what you do...
+
+1. The week always starts on **Wednesday**. First thing you'll do is open the `README.md` for that week. For the first week of `JavaScript2`, that would be [Week1 Reading](/Week1/README.md)
+2. You spend **Wednesday** and **Thursday** going over the resources and try to get a basic understanding of the concepts. In the meanwhile, you'll also implement any feedback you got on last week's homework (from the JavaScript1 module)
+3. On **Friday** you start with the homework, found in the `MAKEME.md`. For the first week of `JavaScript2`, that would be [Week1 Homework](/Week1/MAKEME.md)
+4. You spend **Friday** and **Saturday** playing around with the exercises and write down any questions you might have
+5. **DEADLINE 1**: You'll submit any questions you might have before **Saturday 23.59**, in the class channel
+6. On **Sunday** you'll attend class. It'll be of the Q&A format, meaning that there will be no new material. Instead your questions shall be discussed and you can learn from others
+7. You spend **Monday** and **Tuesday** finalizing your homework
+8. **DEADLINE 2**: You submit your homework to the right channels (GitHub) before **Tuesday 23.59**. If you can't make it on time, please communicate it with your mentor
+9. Start the new week by going back to point 1!
+
+In summary:
+
+
+
+To have a more detailed overview of the guidelines, please read [this document](https://docs.google.com/document/d/1JUaEbxMQTyljAPFsWIbbLwwvvIXZ0VCHmCCN8RaeVIc/edit?usp=sharing) or ask your mentor/class on Slack!
+
+### Video lectures
+
+For each module HackYourFuture provides you with video lectures. These are made by experienced software developers who know what they're talking about. The main teacher for this module will be [Wilgert Velinga](https://hackyourfuture.slack.com/team/UGTGC0T41): senior frontend developer and consultant!
+
+You can find out more about him here:
+
+- [GitHub](https://github.com/wilgert)
+- [@Wilgert on Slack](https://hackyourfuture.slack.com/team/UGTGC0T41)
-After your first class you should start off with checking the `reading materials` for that week. At the beginning that would be the [Week 1 Reading](/Week1/README.md). Study all the concepts and try to get the gist of everything. After, you can get started with the `homework` for that week.
+Learn from Wilgert in the following playlist of videos he has made for you! (Click on the image to open the link)
-If you have any questions or if something is not entirely clear ¯\\\_(ツ)\_/¯, please ask/comment on Slack!
+
## Planning
@@ -49,4 +76,4 @@ If you feel ready for the next challenge, click [here](https://www.github.com/Ha
_The HackYourFuture curriculum is subject to CC BY copyright. This means you can freely use our materials, but just make sure to give us credit for it :)_
-
This work is licensed under a Creative Commons Attribution 4.0 International License.
+
This work is licensed under a Creative Commons Attribution 4.0 International License.```
diff --git a/Week1/MAKEME.md b/Week1/MAKEME.md
index 97fcb029f..01621ec96 100644
--- a/Week1/MAKEME.md
+++ b/Week1/MAKEME.md
@@ -15,7 +15,7 @@ Before we head into the exercises, it might be nice to do some interactive exerc
## **2. JavaScript exercises**
-> Inside of your `JavaScript2` fork, create a folder called `week1`. Inside of that folder, create a folder called `js-exercises`. For all the following exercises create a new `.js` file in that folder (5 files in total). Make sure the name of each file reflects its content: for example, the filename for exercise one could be `bookList.js`.
+> Inside of your `JavaScript2` fork, find the folder called `Week1`. Inside of that folder, find the folder called `js-exercises`. In this folder you will find five `.js` files (sometimes with a matching `.html` file), one for each exercise where you need to write your code. Please use the correct file for the respective exercise.
**Exercise 1: The book list**
@@ -52,7 +52,7 @@ https://hyf-js2-week1-makeme-ex1-demo.herokuapp.com/
**Exercise 2: About me**
-Start with this HTML and save it as "about_me.html":
+Given this HTML:
```html
@@ -86,16 +86,15 @@ No homepage is safe from the logo bandit! Everytime he sees a Google Logo he rep
In this exercise you're expected to write a JavaScript function that can be executed in the console of the [Google website](https://www.google.com).
-1. Inside a JavaScript file, called `hijackGoogleLogo.js`, create a function called hijackGoogleLogo
-2. Find out how to select the element that contains the Google logo, and store it in a variable
-3. Modify the source and sourceset of the logo so that it's replaced by the HackYourFuture logo instead
+1. Find out how to select the element that contains the Google logo, and store it in a variable
+2. Modify the source and sourceset of the logo so that it's replaced by the HackYourFuture logo instead
**Exercise 4: What's the time?**
Why wear a watch when you can check the time, live in your webpage?
-1. Create an empty HTML file, called `time.html`
-2. Create a JavaScript file called `showCurrentTime.js` and include it in the HTML file
+1. Create a basic HTML file
+2. Include a script tag and link the JavaScript file
3. Inside the JS file, write a function that adds the current time to the webpage. Make sure it's written in the HH:MM:SS notation (hour, minute, second). Hint: use `setInterval()` to make sure the time stays current
4. Have the function execute when it's loading in the browser
@@ -116,13 +115,15 @@ Start with this webpage, which has a single img tag of an animated GIF of a cat