Doc revisions1 (#5621)

* Begin reviewing the basics docs.

* Check in delta

* More doc revisions.

* Split apart basics docs.

* Refactor based on building docs

* add the files back as markdown.

* more conversions to markdown.

* more conversions to markdown.

* fix markdown formatting.

* convert index to markdown.

* More docs review

* More markdown and doc revisions.

* Fix docs.

* Update doc build requirements.

* fix lint

* Fix build with update/upgrade command.

* remove useless quickstart and update the commands section.

* Fix lint

* change ordering of table of contents.

* fix changelog duplicate headings.

* Start splitting advanced topics.

* minor nits

* Move some sections from advanced to shell.

* remove this section as its stale and kind of off topic.

* move scripts out into its own section.

* Wrap up revisions1

* fix lint

* address PR feedback and other nits.

* fix lint

* Try improving ordering of table of contents, fix issue with indexes.md file location.

* fix lint

* PR feedback.

CHANGELOG.rst

@@ -1,6 +1,4 @@
 2023.2.18 (2023-02-18)
-======================
-Pipenv 2023.2.18 (2023-02-18)
 =============================
 
 
@@ -32,8 +30,6 @@ Improved Documentation
 
 
 2023.2.4 (2023-02-04)
-=====================
-Pipenv 2023.2.4 (2023-02-04)
 ============================
 
 
@@ -51,8 +47,6 @@ Removals and Deprecations
 
 
 2022.12.19 (2022-12-19)
-=======================
-Pipenv 2022.12.19 (2022-12-19)
 ==============================
 
 
@@ -63,8 +57,6 @@ Bug Fixes
 
 
 2022.12.17 (2022-12-17)
-=======================
-Pipenv 2022.12.17 (2022-12-17)
 ==============================
 
 
@@ -89,8 +81,6 @@ Vendored Libraries
 
 
 2022.11.30 (2022-11-30)
-=======================
-Pipenv 2022.11.30 (2022-11-30)
 ==============================
 
 
@@ -101,8 +91,6 @@ Bug Fixes
 
 
 2022.11.25 (2022-11-24)
-=======================
-Pipenv 2022.11.25 (2022-11-24)
 ==============================
 
 
@@ -113,8 +101,6 @@ Bug Fixes
 
 
 2022.11.24 (2022-11-24)
-=======================
-Pipenv 2022.11.24 (2022-11-24)
 ==============================
 
 
@@ -125,8 +111,6 @@ Bug Fixes
 
 
 2022.11.23 (2022-11-23)
-=======================
-Pipenv 2022.11.23 (2022-11-23)
 ==============================
 
 
@@ -151,8 +135,6 @@ Vendored Libraries
 
 
 2022.11.11 (2022-11-11)
-=======================
-Pipenv 2022.11.11 (2022-11-11)
 ==============================
 
 
@@ -163,8 +145,6 @@ Bug Fixes
 
 
 2022.11.5 (2022-11-05)
-======================
-Pipenv 2022.11.5 (2022-11-05)
 =============================
 
 
@@ -175,8 +155,6 @@ Bug Fixes
 
 
 2022.11.4 (2022-11-04)
-======================
-Pipenv 2022.11.4 (2022-11-04)
 =============================
 
 
@@ -200,8 +178,6 @@ Vendored Libraries
 
 
 2022.10.25 (2022-10-25)
-=======================
-Pipenv 2022.10.25 (2022-10-25)
 ==============================
 
 
@@ -222,8 +198,6 @@ Removals and Deprecations
 
 
 2022.10.12 (2022-10-12)
-=======================
-Pipenv 2022.10.12 (2022-10-12)
 ==============================
 
 
@@ -234,8 +208,6 @@ Improved Documentation
 
 
 2022.10.11 (2022-10-11)
-=======================
-Pipenv 2022.10.11 (2022-10-11)
 ==============================
 
 
@@ -246,8 +218,6 @@ Bug Fixes
 
 
 2022.10.10 (2022-10-10)
-=======================
-Pipenv 2022.10.10 (2022-10-10)
 ==============================
 
 
@@ -264,8 +234,6 @@ Bug Fixes
 
 
 2022.10.9 (2022-10-09)
-======================
-Pipenv 2022.10.9 (2022-10-09)
 =============================
 
 
@@ -281,8 +249,6 @@ Relates to dev process changes
 
 
 2022.10.4 (2022-10-04)
-======================
-Pipenv 2022.10.4 (2022-10-04)
 =============================
 
 
@@ -299,8 +265,6 @@ Vendored Libraries
 
 
 2022.9.24 (2022-09-24)
-======================
-Pipenv 2022.9.24 (2022-09-24)
 =============================
 
 
@@ -311,8 +275,6 @@ Bug Fixes
 
 
 2022.9.21 (2022-09-21)
-======================
-Pipenv 2022.9.21 (2022-09-21)
 =============================
 
 
@@ -323,8 +285,6 @@ Bug Fixes
 
 
 2022.9.20 (2022-09-20)
-======================
-Pipenv 2022.9.20 (2022-09-20)
 =============================
 
 
@@ -361,8 +321,6 @@ Vendored Libraries
 
 
 2022.9.8 (2022-09-08)
-=====================
-Pipenv 2022.9.8 (2022-09-08)
 ============================
 
 

Pipfile

@@ -21,11 +21,13 @@ gunicorn = {version = "*", markers="sys_platform == 'linux'"}
 parse = "*"
 importlib-metadata = {version = "*", markers="python_version < '3.8'"}
 colorama= {version = "*", markers="sys_platform == 'win32'"}
+myst-parser = {extras = ["linkify"], version = "*"}
 invoke = "==2.0.0"
 exceptiongroup = "==1.1.0"
 tomli = "*"
 
 [packages]
+pytz = "*"
 
 [scripts]
 tests = "bash ./run-tests.sh"