docs: Update docs

docs/about-mkdocs.md

@@ -7,7 +7,7 @@ The description on the MkDocs site is:
 
 > Project documentation with Markdown.
 
-MkDocs is a Python tool generates a static site based on content written in *markdown*.
+MkDocs is a Python tool that generates a static site based on content written in Markdown.
 
 If you are new to markdown, see the [Getting Started](https://www.markdownguide.org/getting-started/) page on the Markdown Guide website.
 
@@ -37,4 +37,4 @@ If you are new to markdown, see the [Getting Started](https://www.markdownguide.
 
 ## Do I need to know Python?
 
-MkDocs is built in Python (like Sphynx), but you don't have to write Python code. If you setup a [Deploy](deloy) flow right, you don't even have to set it up locally, though then you can't preview.
+MkDocs is built in Python (like Sphinx), but you don't have to write Python code. If you setup a [Deploy](deploy) flow right, you don't even have to set it up locally, though then you can't preview.

docs/tutorial/setup-project.md

@@ -25,7 +25,7 @@ This is the simplest MkDocs site you can make:
 
 A requirements file is optional but it can make it easier to manage dependencies. If you choose not use the file, make sure `pip install mkdocs` and `pip install THEME` lines are your instructions.
 
-If you want to add, then include `requirements.txt` at the root. If your project is already a Python project, you might prefer to add `mkdocs` in `dev-requirements.txt` or at `docs/requirements.txt` to keep it isolated.This file should have `mkdocs` in it and also any themes if needed.
+If you want to add, then include `requirements.txt` at the root. If your project is already a Python project, you might prefer to add `mkdocs` in `requirements-dev.txt` or at `docs/requirements.txt` to keep it isolated.This file should have `mkdocs` in it and also any themes if needed.
 
 
 ### Create a starter site
@@ -39,7 +39,6 @@ mkdocs new PATH
 
 The result will be same as the [Basic structure](#basic-structure) defined above and will include minimal text content generated by the MkDocs CLI. This text is defined in the project's [new.py](https://github.com/mkdocs/mkdocs/blob/master/mkdocs/commands/new.py) module.
 
-
 ### Setup a docs site
 
 _Tip: Optionally use the `new` command covered above to setup the config and index page first and then continue_.

docs/tutorial/usage.md

@@ -1,8 +1,6 @@
 # Usage
 > Build and preview a site locally
 
-_Note: If using VS Code, you can use the command palette instead to run the configured tasks - these are setup in `.vscode/tasks.json`. However, using a `Makefile` allows more control locally and on for a remote build._
-
 
 ## Serve docs