wrote more content for week 1, added tutorials for code along

Noer Paanakker · Noer Paanakker · commit 75e18ebf6592 · 2019-08-07T17:56:06.000+02:00
diff --git a/Week1/MAKEME.md b/Week1/MAKEME.md
@@ -15,6 +15,13 @@
 
 ## **3. Code along**
 
+Now that you've learned about APIs and how to connect with them, let's apply it in the context of a complete application.
+
+In
+
+- [Vanilla JS Numbers Facts App - AJAX & Fetch](https://www.youtube.com/watch?v=tUE2Nic21BA)
+- [Build a JavaScript & jQuery Movie Info App](https://www.youtube.com/watch?v=YsPqjYGauns)
+
 ## **4. PROJECT: Hack Your Repo I**
 
 > In this assignment you will built upon some existing code that is already pre-written by your teachers. Your homework consist of writing the code to make the application work as requested per week.
diff --git a/Week1/README.md b/Week1/README.md
@@ -11,12 +11,16 @@ These are the topics for week 1:
    - XMLHttpRequest (XHR)
    - What is JSON?
 3. jQuery
-   - What's a module/package?
+   - What's a module?
    - What's a library?
    - Using jQuery to make AJAX requests
 
 ## 1. Application Programming Interface (API)
 
+An Application Programming Interface, or API for short, is
+
+You can think of APIs in the following manner: Imagine you want to rent out a room in your house through Airbnb.
+
 - [What are APIs - series](https://www.youtube.com/watch?v=cpRcK4GS068&list=PLcgRuP1JhcBP8Kh0MC53GH_pxqfOhTVLa)
 
 ### Public/private APIs
@@ -41,20 +45,40 @@ It's because the HackYourFuture website sends an **API call** to Mollie. The req
 
 > Anytime a request to an API is made this is called an `API call`. However, in practice people use different terms for the same thing. Synonyms for `API call` are `API request`, `Network call/request` or`HTTP call/request`. Which do you prefer?
 
+For further study of how to make API calls, check out the following resources:
+
 - [Working with APIs in JavaScript](https://www.youtube.com/watch?v=ecT42O6I_WI)
 - [Making HTTP Requests in JavaScript](https://www.kirupa.com/html5/making_http_requests_js.htm)
 
 ## 2. Asynchronous JavaScript and XML (AJAX)
 
+AJAX is the idea that data can be loaded into a webpage without refreshing the entire website.
+
 ### XMLHttpRequests (XHR)
 
 - [XMLHttpRequest](../../../../fundamentals/blob/master/fundamentals/XMLHttpRequest.md)
 - [AJAX Crash Course](https://www.youtube.com/watch?v=82hnvUYY6QA)
 
 ## 3. jQuery
 
-### What's a module/package?
+### What's a module?
+
+A `module` is a part of a program that contains one or more functionalities. For example, a single function that has only 1 job could be considered a module. When developing applications you'll always be writing multiple functionalities in order for your software to work as expected. These can be written all in one file, and it would fine. The browser/operating system would be able to interpret and execute it anyway. But for you, the human, it's very hard to keep overview of what is happening at what level of the application.
+
+In order to keep a better overview, we can choose to **modularize** our application: split it up into smaller parts that, in theory, all work independently.
+
+However, creating better overview is not the only reason. Among other reasons, modules make a developer's job easy by:
+
+- Allowing the them to focus on only one area of the functionality of the software application
+- Isolating individual blocks of code, in case anything breaks
+- Encouraging the developer to write code in a way that makes it reusable
+
+For more information about this, go through the following:
+
+- [JavaScript Modules: From IIFEs to CommonJS to ES6 Modules](https://www.youtube.com/watch?v=qJWALEoGge4)
 
 ### What's a library?
 
 ### Using jQuery to make AJAX requests
+
+One of the most well-known and often used libraries in JavaScript is called `jQuery`. It's a library that was designed to make DOM manipulation, as well as event handling, CSS animation and AJAX operations much easier to perform.
diff --git a/Week2/MAKEME.md b/Week2/MAKEME.md
@@ -17,37 +17,6 @@
 
 ## **4. PROJECT: Hack Your Repo II**
 
-# Homework Week 2
-
-```
-Topics discussed this week:
-• Async vs Sync
-• Event Loop (order of execution)
-• Promises
-```
-
-## Step 1: Read
-
-- Read this article on scopes & closures: [explaining-javascript-scope-and-closures](https://robertnyman.com/2008/10/09/explaining-javascript-scope-and-closures/)
-
-- If you are still not completely clear on promises, here are some additional resources :ring:
-
-  - [Google's post about Promises](https://developers.google.com/web/fundamentals/getting-started/primers/promises)
-  - [A nice article from David Walsh](https://davidwalsh.name/promises)
-  - [A real life example](https://github.com/mdn/js-examples/blob/master/promises-test/index.html)
-  - [stackoverflow](http://stackoverflow.com/questions/13343340/calling-an-asynchronous-function-within-a-for-loop-in-javascript)
-  - YouTube: [promises](https://www.youtube.com/watch?v=WBupia9oidU)
-
-## Step 2: Implement requested PR changes
-
-- Fix Requested Changes (if any) on the Pull Request.
-
-## Step 3: Convert callbacks to promises
-
-**_Deadline Thursday_**
-
-### 3.1 Preparation
-
 The homework for week 2 will build on the work you did in week 1. You will create a new branch based on the `week1` branch.
 
 1. Make sure that you committed all changes in the week 1 version of your homework.
@@ -61,31 +30,10 @@ The homework for week 2 will build on the work you did in week 1. You will creat
 
 You will continue to work on the files `index.js` and (possibly) `style.css`.
 
-- Complete your GitHub app code from the previous week, if needed, to meet the requirements from that week's assignment.
 - Replace all asynchronous callbacks (e.g. as used with XMLHttpRequest) by ES6 promises.
 - Beautify your app's styling.
 - If not yet completed in week 1, make your app responsive (use CSS media queries and [Flexbox](https://css-tricks.com/snippets/css/a-guide-to-flexbox/)).
 
-### 3.3 Handing in your homework
-
-If necessary, review the instructions how to [Hand in homework](https://github.com/HackYourFuture/fundamentals/blob/master/fundamentals/homework_pr.md) using GitHub pull request.
-
-To test whether your code will be accepted when you submit your homework as a pull request you need to ensure that it does not contain ESLinr errors. Open a terminal window in VSCode and type the following command:
-
-```
-npm test
-```
-
-If any errors or warnings are reported by this command you need to fix them before submitting a pull request.
-
-In addition, check for the following:
-
-- Have you removed all commented out code (should never be present in a PR)?
-- Do the variable, function and argument names you created follow the [Naming Conventions](../../../../fundamentals/blob/master/fundamentals/naming_conventions.md)?
-- Is your code well-formatted (see [Code Formatting](../../../../fundamentals/blob/master/fundamentals/code_formatting.md))?
-
-If the answer is 'yes' to the preceding questions you are ready to follow these instructions:
-
 1. Push your `week2` branch to GitHub:
 
    ```
@@ -94,11 +42,4 @@ If the answer is 'yes' to the preceding questions you are ready to follow these
 
 2. Create a pull request for your `week2` branch.
 
-Note:
-
-1. Please remove all redundant, commented-out code and console.log's from your files before pushing your homework as finished. There is no need for your mentors to review this stuff.
-2. Please make sure your code is well-formatted and follows the recommended naming conventions.
-
-## Step 4: Read before next lecture
-
-Go through the reading material in the [README.md](../Week3/README.md) to prepare for your next class.
+> Note: Please remove all redundant, commented-out code and console.log's from your files before pushing your homework as finished. There is no need for your mentors to review this stuff. Also, please make sure your code is well-formatted and follows the recommended naming conventions.
diff --git a/Week3/MAKEME.md b/Week3/MAKEME.md
@@ -13,58 +13,15 @@
 
 ## **3. Code along**
 
-## **4. PROJECT: Hack Your Repo III**
-
-# Homework Week 3
-
-```
-Topics discussed this week:
-• Object Oriented Programming and ES6 Classes
-• The this keyword
-• call, apply, bind
-```
-
-## Step 1: Fix requested changes
-
-_Deadline Monday_
-
-- Fix Requested Changes (if any) on the Pull Request.
-
-## Step 2
-
-**_Deadline Thursday_**
-
-### 2.1 Preparation
-
-**Read the fundamental pages on:**
+- [YouTube API Project with Authentication](https://www.youtube.com/watch?v=r-yxNNO1EI8)
 
-- [try...catch](../../../../fundamentals/blob/master/fundamentals/try_catch.md)
-- [async/await](../../../../fundamentals/blob/master/fundamentals/async_await.md)
-
-The homework for week 3 will build on the work you did in week 2. You will create a new branch based on the `week2` branch.
-
-1. Make sure that you committed all changes in the week 2 version of your homework.
-2. Create a new `week3` branch:
-
-   ```
-   git checkout -b week3
-   ```
-
-### 2.2 Assignment
+## **4. PROJECT: Hack Your Repo III**
 
 This week you will work with all JavaScript files in the `src` folder. The assignment consists of two parts:
 
 1. Refactor all `.then()` and `.catch()` methods with `async`/`await` and `try...catch`.
 2. Refactor your application to use ES6 classes.
 
-#### 2.2.1 async/await
-
-**Instructions:**
-
-1. Refactor all `.then()` and `.catch()` methods with `async`/`await` and `try...catch`.
-
-2. Make sure that your error handling code still works. See the week2 MAKEME on how to force an error response from GitHub.
-
 #### 2.2.2 ES6 Classes
 
 **_Deadline Saturday_**
