Fully update sidebar to show options; group best practices

olivialynn · olivialynn · commit 7a1a7f22cccf · 2024-06-14T13:16:11.000-04:00
diff --git a/docs/index.rst b/docs/index.rst
@@ -43,18 +43,12 @@ please :doc:`/source/contact`
    :hidden:
 
    practices/overview
-   practices/ci_benchmarking
-   practices/ci_precommit
-   practices/ci_testing
-   practices/code_coverage
-   practices/git-lfs
-   practices/issue_pr_templating
+   practices/precommit
+   practices/environment_management
    practices/linting
+   practices/ci
    practices/namespace_project
-   practices/pipx
-   practices/precommit
-   practices/pypi
-   practices/conda
-   practices/unit_testing
-   practices/pytest_timeout
+   practices/issue_pr_templating
    practices/sphinx
+   practices/pypi
+
diff --git a/docs/practices/ci.rst b/docs/practices/ci.rst
@@ -0,0 +1,13 @@
+Continuous Integration
+===============================================================================
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Continuous Integration
+
+   ci_testing
+   ci_benchmarking
+   ci_precommit
+   code_coverage
+   unit_testing
+   pytest_timeout
diff --git a/docs/practices/environment_management.rst b/docs/practices/environment_management.rst
@@ -0,0 +1,8 @@
+Env Management: pipx, conda
+===============================================================================
+
+.. toctree::
+   :maxdepth: 1
+
+   pipx
+   conda
diff --git a/docs/practices/git-lfs.rst b/docs/practices/git-lfs.rst
diff --git a/docs/practices/linting.rst b/docs/practices/linting.rst
@@ -1,4 +1,4 @@
-Code Style
+Code Style: Linters, Auto-Formatters
 ===============================================================================
 
 What is it? Why do it?
diff --git a/docs/practices/namespace_project.rst b/docs/practices/namespace_project.rst
@@ -1,5 +1,5 @@
-Python namespace project
-========================
+Python Namespace Projects
+=========================
 
 `Pep 420 <https://peps.python.org/pep-0420/>`_ defines a standard for namespace packages. 
 This standard allows for separately versioned and maintained subpackages to present 
diff --git a/docs/practices/overview.rst b/docs/practices/overview.rst
@@ -19,7 +19,6 @@ Practices
 * :doc:`precommit`
 * :doc:`pypi`
 * :doc:`sphinx`
-* :doc:`git-lfs`
 * :doc:`pytest_timeout`
 
 Still have questions?
diff --git a/docs/practices/pipx.rst b/docs/practices/pipx.rst
@@ -1,5 +1,5 @@
 pipx
-=========
+====================================================================================================
 
 ``pipx`` is a tool to enable installation of end-user applications written 
 in Python.
diff --git a/docs/practices/pypi.rst b/docs/practices/pypi.rst
@@ -1,4 +1,4 @@
-PyPI
+PyPI Publishing
 ===============================================================================
 
 What is it? Why do it?
diff --git a/docs/practices/sphinx.rst b/docs/practices/sphinx.rst
@@ -1,4 +1,4 @@
-Sphinx - ReadTheDocs and AutoAPI
+Sphinx: ReadTheDocs, AutoAPI
 ===============================================================================
 
 What is it? Why do it?
diff --git a/docs/source/contributing.rst b/docs/source/contributing.rst
@@ -1,4 +1,4 @@
-Contributing to the template
+Contribute to the template
 ===============================================================================
 
 Find (or make) a new GitHub issue
diff --git a/docs/source/existing_project.rst b/docs/source/existing_project.rst
@@ -1,4 +1,4 @@
-Hydrate a pre-template project
+or, Hydrate an un-templated project
 ===============================================================================
 
 These instructions are for those who want to incorporate the latest version of the 
diff --git a/docs/source/new_project.rst b/docs/source/new_project.rst
@@ -1,4 +1,4 @@
-Creating a new project
+Create a new templated project
 ===============================================================================
 
 
diff --git a/docs/source/template_options.rst b/docs/source/template_options.rst
diff --git a/docs/source/update_project.rst b/docs/source/update_project.rst

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-Code Style`
	`1`	`+Code Style: Linters, Auto-Formatters`
`2`	`2`	`===============================================================================`
`3`	`3`
`4`	`4`	`What is it? Why do it?`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-PyPI`
	`1`	`+PyPI Publishing`
`2`	`2`	`===============================================================================`
`3`	`3`
`4`	`4`	`What is it? Why do it?`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-Sphinx - ReadTheDocs and AutoAPI`
	`1`	`+Sphinx: ReadTheDocs, AutoAPI`
`2`	`2`	`===============================================================================`
`3`	`3`
`4`	`4`	`What is it? Why do it?`