docs: fix README.md (#33142)

* md

* Update README.md

* rename

* exclude

* Update README.md
old-commit-hash: 086dcfe

Author: maxime-desroches

docs/README docs/README.mddocs/README renamed to docs/README.md

@@ -3,18 +3,22 @@
 This is the source for [docs.comma.ai](https://docs.comma.ai).
 The site is updated on pushes to master by this [workflow](../.github/workflows/docs.yaml).
 
-## development
-```
-# install the docs dependencies
+## Development
+NOTE: Those commands must be run in the root directory of openpilot, **not /docs**
+
+**1. Install the docs dependencies**
+``` bash
 pip install .[docs]
+```
 
-cd docs/
+**2. Build the new site**
+``` bash
+mkdocs build
+```
 
-# for a development server
+**3. Run the new site locally**
+``` bash
 mkdocs serve
-
-# build the site
-mkdocs build
 ```
 
 References:

mkdocs.yml

@@ -2,6 +2,8 @@ site_name: openpilot docs
 repo_url: https://github.com/commaai/openpilot/
 site_url: https://docs.comma.ai
 
+exclude_docs: README.md
+
 strict: true
 docs_dir: docs
 site_dir: docs_site/