made README.md more readable and added script to run docsify in package.json

README.md

@@ -96,7 +96,69 @@ While we have purposefully avoided introducing JavaScript frameworks so as to co
 
 ## Offline access
 
-You can run this documentation offline by using [Docsify](https://docsify.js.org/#/). Fork this repo, [install Docsify](https://docsify.js.org/#/quickstart) on your local machine, and then in the root folder of this repo, type `docsify serve`. The website will be served on port 3000 on your localhost: `localhost:3000`.
+You can run this documentation offline by using [Docsify](https://docsify.js.org/#/). 
+
+## Fork this repository
+
+Fork this repository by clicking on the fork button on the top of this page.
+This will create a copy of this repository in your account.
+
+## Clone the repository
+
+Now clone the forked repository to your machine. Go to your GitHub account, open the forked repository, click on the code button and then click the _copy to clipboard_ icon.
+
+Open a terminal and run the following git command:
+
+```
+git clone "url you just copied"
+```
+
+where "url you just copied" (without the quotation marks) is the url to this repository (your fork of this project). See the previous steps to obtain the url.
+
+For example:
+
+```
+git clone https://github.com/this-is-you/Web-Dev-For-Beginners.git
+```
+
+where `this-is-you` is your GitHub username. Here you're copying the contents of the Web-Dev-For-Beginners repository on GitHub to your computer.
+
+## Change Directory
+
+Change to the repository directory on your computer (if you are not already there):
+
+```
+cd Web-Dev-For-Beginners
+```
+
+## Install All Dependencies
+
+```
+npm i
+```
+
+## Install Docsify
+
+```
+npm i docsify
+```
+
+## Under Scripts In package.json
+
+```
+"start": "docsify serve "
+```
+## Run script
+
+```
+npm start
+```
+
+## Open Tab
+
+```
+http://localhost:3000
+```
 
 ## PDF
 

package-lock.json

@@ -1,13 +1,16 @@
 {
-	"name": "ml-for-beginners",
+	"name": "web-dev-for-beginners",
 	"version": "1.0.0",
 	"lockfileVersion": 2,
 	"requires": true,
 	"packages": {
 		"": {
-			"name": "ml-for-beginners",
+			"name": "web-dev-for-beginners",
 			"version": "1.0.0",
 			"license": "MIT",
+			"dependencies": {
+				"docsify": "^4.12.2"
+			},
 			"devDependencies": {
 				"docsify-to-pdf": "0.0.5"
 			}
@@ -589,13 +592,12 @@
 			"dev": true
 		},
 		"node_modules/docsify": {
-			"version": "4.12.1",
+			"version": "4.12.2",
-			"resolved": "https://registry.npmjs.org/docsify/-/docsify-4.12.1.tgz",
+			"resolved": "https://registry.npmjs.org/docsify/-/docsify-4.12.2.tgz",
-			"integrity": "sha512-7v4UlCYLTmb83leJLIlheQlQ8kDTbTxcpMttRg0Uf92Nl//m0AcKFHoLLo5HHS4UhnO0KhDV8SKCdTR279zI9A==",
+			"integrity": "sha512-hpRez5upcvkYigT2zD8P5kH5t9HpSWL8yn/ZU/g04/WfAfxVNW6CPUVOOF1EsQUDxTRuyNTFOb6uUv+tPij3tg==",
-			"dev": true,
 			"hasInstallScript": true,
 			"dependencies": {
-				"dompurify": "^2.2.6",
+				"dompurify": "^2.3.1",
 				"marked": "^1.2.9",
 				"medium-zoom": "^1.0.6",
 				"opencollective-postinstall": "^2.0.2",
@@ -695,10 +697,9 @@
 			}
 		},
 		"node_modules/dompurify": {
-			"version": "2.2.9",
+			"version": "2.4.0",
-			"resolved": "https://registry.npmjs.org/dompurify/-/dompurify-2.2.9.tgz",
+			"resolved": "https://registry.npmjs.org/dompurify/-/dompurify-2.4.0.tgz",
-			"integrity": "sha512-+9MqacuigMIZ+1+EwoEltogyWGFTJZWU3258Rupxs+2CGs4H914G9er6pZbsme/bvb5L67o2rade9n21e4RW/w==",
+			"integrity": "sha512-Be9tbQMZds4a3C6xTmz68NlMfeONA//4dOavl/1rNw50E+/QO0KVpbcU0PcaW0nsQxurXls9ZocqFxk8R2mWEA=="
-			"dev": true
 		},
 		"node_modules/dot-prop": {
 			"version": "5.3.0",
@@ -1480,7 +1481,6 @@
 			"version": "1.2.9",
 			"resolved": "https://registry.npmjs.org/marked/-/marked-1.2.9.tgz",
 			"integrity": "sha512-H8lIX2SvyitGX+TRdtS06m1jHMijKN/XjfH6Ooii9fvxMlh8QdqBfBDkGUpMWH2kQNrtixjzYUa3SH8ROTgRRw==",
-			"dev": true,
 			"bin": {
 				"marked": "bin/marked"
 			},
@@ -1491,8 +1491,7 @@
 		"node_modules/medium-zoom": {
 			"version": "1.0.6",
 			"resolved": "https://registry.npmjs.org/medium-zoom/-/medium-zoom-1.0.6.tgz",
-			"integrity": "sha512-UdiUWfvz9fZMg1pzf4dcuqA0W079o0mpqbTnOz5ip4VGYX96QjmbM+OgOU/0uOzAytxC0Ny4z+VcYQnhdifimg==",
+			"integrity": "sha512-UdiUWfvz9fZMg1pzf4dcuqA0W079o0mpqbTnOz5ip4VGYX96QjmbM+OgOU/0uOzAytxC0Ny4z+VcYQnhdifimg=="
-			"dev": true
 		},
 		"node_modules/mime": {
 			"version": "1.6.0",
@@ -1519,7 +1518,6 @@
 			"version": "1.0.1",
 			"resolved": "https://registry.npmjs.org/min-indent/-/min-indent-1.0.1.tgz",
 			"integrity": "sha512-I9jwMn07Sy/IwOj3zVkVik2JTvgpaykDZEigL6Rx6N9LbMywwUSMtxET+7lVoDLLd3O3IXwJwvuuns8UB/HeAg==",
-			"dev": true,
 			"engines": {
 				"node": ">=4"
 			}
@@ -1659,7 +1657,6 @@
 			"version": "2.0.3",
 			"resolved": "https://registry.npmjs.org/opencollective-postinstall/-/opencollective-postinstall-2.0.3.tgz",
 			"integrity": "sha512-8AV/sCtuzUeTo8gQK5qDZzARrulB3egtLzFgteqB2tcT4Mw7B8Kt7JcDHmltjz6FOAHsvTevk70gZEbhM4ZS9Q==",
-			"dev": true,
 			"bin": {
 				"opencollective-postinstall": "index.js"
 			}
@@ -1854,7 +1851,6 @@
 			"version": "1.27.0",
 			"resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.27.0.tgz",
 			"integrity": "sha512-t13BGPUlFDR7wRB5kQDG4jjl7XeuH6jbJGt11JHPL96qwsEHNX2+68tFXqc1/k+/jALsbSWJKUOT/hcYAZ5LkA==",
-			"dev": true,
 			"engines": {
 				"node": ">=6"
 			}
@@ -2315,7 +2311,6 @@
 			"version": "3.0.0",
 			"resolved": "https://registry.npmjs.org/strip-indent/-/strip-indent-3.0.0.tgz",
 			"integrity": "sha512-laJTa3Jb+VQpaC6DseHhF7dXVqHTfJPCRDaEbid/drOhgitgYku/letMUqOXFoWV0zIIUbjpdH2t+tYj4bQMRQ==",
-			"dev": true,
 			"dependencies": {
 				"min-indent": "^1.0.0"
 			},
@@ -2360,7 +2355,6 @@
 			"version": "1.3.0",
 			"resolved": "https://registry.npmjs.org/tinydate/-/tinydate-1.3.0.tgz",
 			"integrity": "sha512-7cR8rLy2QhYHpsBDBVYnnWXm8uRTr38RoZakFSW7Bs7PzfMPNZthuMLkwqZv7MTu8lhQ91cOFYS5a7iFj2oR3w==",
-			"dev": true,
 			"engines": {
 				"node": ">=4"
 			}
@@ -2404,8 +2398,7 @@
 		"node_modules/tweezer.js": {
 			"version": "1.5.0",
 			"resolved": "https://registry.npmjs.org/tweezer.js/-/tweezer.js-1.5.0.tgz",
-			"integrity": "sha512-aSiJz7rGWNAQq7hjMK9ZYDuEawXupcCWgl3woQQSoDP2Oh8O4srWb/uO1PzzHIsrPEOqrjJ2sUb9FERfzuBabQ==",
+			"integrity": "sha512-aSiJz7rGWNAQq7hjMK9ZYDuEawXupcCWgl3woQQSoDP2Oh8O4srWb/uO1PzzHIsrPEOqrjJ2sUb9FERfzuBabQ=="
-			"dev": true
 		},
 		"node_modules/type-fest": {
 			"version": "0.8.1",
@@ -3289,12 +3282,11 @@
 			"dev": true
 		},
 		"docsify": {
-			"version": "4.12.1",
+			"version": "4.12.2",
-			"resolved": "https://registry.npmjs.org/docsify/-/docsify-4.12.1.tgz",
+			"resolved": "https://registry.npmjs.org/docsify/-/docsify-4.12.2.tgz",
-			"integrity": "sha512-7v4UlCYLTmb83leJLIlheQlQ8kDTbTxcpMttRg0Uf92Nl//m0AcKFHoLLo5HHS4UhnO0KhDV8SKCdTR279zI9A==",
+			"integrity": "sha512-hpRez5upcvkYigT2zD8P5kH5t9HpSWL8yn/ZU/g04/WfAfxVNW6CPUVOOF1EsQUDxTRuyNTFOb6uUv+tPij3tg==",
-			"dev": true,
 			"requires": {
-				"dompurify": "^2.2.6",
+				"dompurify": "^2.3.1",
 				"marked": "^1.2.9",
 				"medium-zoom": "^1.0.6",
 				"opencollective-postinstall": "^2.0.2",
@@ -3377,10 +3369,9 @@
 			}
 		},
 		"dompurify": {
-			"version": "2.2.9",
+			"version": "2.4.0",
-			"resolved": "https://registry.npmjs.org/dompurify/-/dompurify-2.2.9.tgz",
+			"resolved": "https://registry.npmjs.org/dompurify/-/dompurify-2.4.0.tgz",
-			"integrity": "sha512-+9MqacuigMIZ+1+EwoEltogyWGFTJZWU3258Rupxs+2CGs4H914G9er6pZbsme/bvb5L67o2rade9n21e4RW/w==",
+			"integrity": "sha512-Be9tbQMZds4a3C6xTmz68NlMfeONA//4dOavl/1rNw50E+/QO0KVpbcU0PcaW0nsQxurXls9ZocqFxk8R2mWEA=="
-			"dev": true
 		},
 		"dot-prop": {
 			"version": "5.3.0",
@@ -3991,14 +3982,12 @@
 		"marked": {
 			"version": "1.2.9",
 			"resolved": "https://registry.npmjs.org/marked/-/marked-1.2.9.tgz",
-			"integrity": "sha512-H8lIX2SvyitGX+TRdtS06m1jHMijKN/XjfH6Ooii9fvxMlh8QdqBfBDkGUpMWH2kQNrtixjzYUa3SH8ROTgRRw==",
+			"integrity": "sha512-H8lIX2SvyitGX+TRdtS06m1jHMijKN/XjfH6Ooii9fvxMlh8QdqBfBDkGUpMWH2kQNrtixjzYUa3SH8ROTgRRw=="
-			"dev": true
 		},
 		"medium-zoom": {
 			"version": "1.0.6",
 			"resolved": "https://registry.npmjs.org/medium-zoom/-/medium-zoom-1.0.6.tgz",
-			"integrity": "sha512-UdiUWfvz9fZMg1pzf4dcuqA0W079o0mpqbTnOz5ip4VGYX96QjmbM+OgOU/0uOzAytxC0Ny4z+VcYQnhdifimg==",
+			"integrity": "sha512-UdiUWfvz9fZMg1pzf4dcuqA0W079o0mpqbTnOz5ip4VGYX96QjmbM+OgOU/0uOzAytxC0Ny4z+VcYQnhdifimg=="
-			"dev": true
 		},
 		"mime": {
 			"version": "1.6.0",
@@ -4015,8 +4004,7 @@
 		"min-indent": {
 			"version": "1.0.1",
 			"resolved": "https://registry.npmjs.org/min-indent/-/min-indent-1.0.1.tgz",
-			"integrity": "sha512-I9jwMn07Sy/IwOj3zVkVik2JTvgpaykDZEigL6Rx6N9LbMywwUSMtxET+7lVoDLLd3O3IXwJwvuuns8UB/HeAg==",
+			"integrity": "sha512-I9jwMn07Sy/IwOj3zVkVik2JTvgpaykDZEigL6Rx6N9LbMywwUSMtxET+7lVoDLLd3O3IXwJwvuuns8UB/HeAg=="
-			"dev": true
 		},
 		"minimatch": {
 			"version": "3.0.4",
@@ -4117,8 +4105,7 @@
 		"opencollective-postinstall": {
 			"version": "2.0.3",
 			"resolved": "https://registry.npmjs.org/opencollective-postinstall/-/opencollective-postinstall-2.0.3.tgz",
-			"integrity": "sha512-8AV/sCtuzUeTo8gQK5qDZzARrulB3egtLzFgteqB2tcT4Mw7B8Kt7JcDHmltjz6FOAHsvTevk70gZEbhM4ZS9Q==",
+			"integrity": "sha512-8AV/sCtuzUeTo8gQK5qDZzARrulB3egtLzFgteqB2tcT4Mw7B8Kt7JcDHmltjz6FOAHsvTevk70gZEbhM4ZS9Q=="
-			"dev": true
 		},
 		"opts": {
 			"version": "2.0.2",
@@ -4252,8 +4239,7 @@
 		"prismjs": {
 			"version": "1.27.0",
 			"resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.27.0.tgz",
-			"integrity": "sha512-t13BGPUlFDR7wRB5kQDG4jjl7XeuH6jbJGt11JHPL96qwsEHNX2+68tFXqc1/k+/jALsbSWJKUOT/hcYAZ5LkA==",
+			"integrity": "sha512-t13BGPUlFDR7wRB5kQDG4jjl7XeuH6jbJGt11JHPL96qwsEHNX2+68tFXqc1/k+/jALsbSWJKUOT/hcYAZ5LkA=="
-			"dev": true
 		},
 		"process-nextick-args": {
 			"version": "2.0.1",
@@ -4632,7 +4618,6 @@
 			"version": "3.0.0",
 			"resolved": "https://registry.npmjs.org/strip-indent/-/strip-indent-3.0.0.tgz",
 			"integrity": "sha512-laJTa3Jb+VQpaC6DseHhF7dXVqHTfJPCRDaEbid/drOhgitgYku/letMUqOXFoWV0zIIUbjpdH2t+tYj4bQMRQ==",
-			"dev": true,
 			"requires": {
 				"min-indent": "^1.0.0"
 			}
@@ -4661,8 +4646,7 @@
 		"tinydate": {
 			"version": "1.3.0",
 			"resolved": "https://registry.npmjs.org/tinydate/-/tinydate-1.3.0.tgz",
-			"integrity": "sha512-7cR8rLy2QhYHpsBDBVYnnWXm8uRTr38RoZakFSW7Bs7PzfMPNZthuMLkwqZv7MTu8lhQ91cOFYS5a7iFj2oR3w==",
+			"integrity": "sha512-7cR8rLy2QhYHpsBDBVYnnWXm8uRTr38RoZakFSW7Bs7PzfMPNZthuMLkwqZv7MTu8lhQ91cOFYS5a7iFj2oR3w=="
-			"dev": true
 		},
 		"to-readable-stream": {
 			"version": "1.0.0",
@@ -4694,8 +4678,7 @@
 		"tweezer.js": {
 			"version": "1.5.0",
 			"resolved": "https://registry.npmjs.org/tweezer.js/-/tweezer.js-1.5.0.tgz",
-			"integrity": "sha512-aSiJz7rGWNAQq7hjMK9ZYDuEawXupcCWgl3woQQSoDP2Oh8O4srWb/uO1PzzHIsrPEOqrjJ2sUb9FERfzuBabQ==",
+			"integrity": "sha512-aSiJz7rGWNAQq7hjMK9ZYDuEawXupcCWgl3woQQSoDP2Oh8O4srWb/uO1PzzHIsrPEOqrjJ2sUb9FERfzuBabQ=="
-			"dev": true
 		},
 		"type-fest": {
 			"version": "0.8.1",

package.json

@@ -4,7 +4,8 @@
 	"description": "Web Dev for Beginners - A Curriculum",
 	"main": "index.js",
 	"scripts": {
-		"convert": "node_modules/.bin/docsify-to-pdf"
+		"convert": "node_modules/.bin/docsify-to-pdf",
+        "start": "docsify serve "
 	},
 	"repository": {
 		"type": "git",
@@ -24,5 +25,8 @@
 	"homepage": "https://github.com/microsoft/Web-Dev-For-Beginners#readme",
 	"devDependencies": {
 		"docsify-to-pdf": "0.0.5"
+	},
+	"dependencies": {
+		"docsify": "^4.12.2"
 	}
 }