Repository: imAsparky/django-cookiecutter

Issue:
[DOCS]: Migrate docs to Django project
**Describe alternatives you've considered**
Would you please share your clear and concise description of any alternative/similar documentation you've considered.



**Additional context**
Would you please share any other context or screenshots about the documentation request here.



Discussion:

Resolving patch:
diff --git a/hooks/post_gen_project.py b/hooks/post_gen_project.py
--- a/hooks/post_gen_project.py
+++ b/hooks/post_gen_project.py
@@ -26,7 +26,7 @@
     '{% if cookiecutter.include_documentation_templates == "n" %} \
         docs/source/doc-templates {% endif %}',
     '{% if cookiecutter.include_how_to_contribute_template == "n" %} \
-        docs/source/how-tos/how-to-contribute.rst {% endif %}',
+        docs/source/how-to-guides/how-to-contribute.rst {% endif %}',
     '{% if cookiecutter.open_source_license == "Not open source" %} \
         LICENSE.rst {% endif %}',
     '{% if cookiecutter.create_conventional_commits_edit_message == "n" %} \
@@ -69,7 +69,6 @@ def post_gen_setup(*args, supress_exception=False, cwd=None):
         with subprocess.Popen(  # nosec
             args, stdout=subprocess.PIPE, stderr=subprocess.PIPE
         ) as proc:
-
             out, err = proc.communicate()
             out = out.decode("utf-8")
             err = err.decode("utf-8")
@@ -173,23 +172,21 @@ def git_configure_custom_commit_message():
 
 
 def final_checks_reminders_for_users():
-
     print(
-            "\nSUCCESS: Your {{cookiecutter.project_name}} \
+        "\nSUCCESS: Your {{cookiecutter.project_name}} \
             has been generated successfully!",
-            "\nSome things to remember:"
-            "\n1. If using the email admins with errors feature, in config.settings.base",
-            "\n\ta. Review DJANGO_LOGGING_LEVEL meets your needs. ",
-            "\n\tb. Add names and emails to ADMINS. ",
-            "\n\tc. Review MANAGERS meets your needs ",
-            "\n\td. Review SERVER_EMAIL meets your needs ",
-            "\n You can find all these settings grouped together under: # Logging Settings",
-            "\n\n Thank you for using Django-Cookiecutter, I hope you enjoyed this experience."
-        )
+        "\nSome things to remember:"
+        "\n1. If using the email admins with errors feature, in config.settings.base",
+        "\n\ta. Review DJANGO_LOGGING_LEVEL meets your needs. ",
+        "\n\tb. Add names and emails to ADMINS. ",
+        "\n\tc. Review MANAGERS meets your needs ",
+        "\n\td. Review SERVER_EMAIL meets your needs ",
+        "\n You can find all these settings grouped together under: # Logging Settings",
+        "\n\n Thank you for using Django-Cookiecutter, I hope you enjoyed this experience.",
+    )
 
 
 if __name__ == "__main__":
-
     remove_files(REMOVE_FILES)
 
     # Git options
diff --git a/{{cookiecutter.git_project_name}}/docs/source/_static/reference/rest/reST-literalinclude/code_examples_2/square_example_2.py b/{{cookiecutter.git_project_name}}/docs/source/_static/reference/rest/reST-literalinclude/code_examples_2/square_example_2.py
new file mode 100644
--- /dev/null
+++ b/{{cookiecutter.git_project_name}}/docs/source/_static/reference/rest/reST-literalinclude/code_examples_2/square_example_2.py
@@ -0,0 +1,13 @@
+""" A very very simple square function"""
+
+
+def square(a):
+    """a very simple squaring function
+
+    long description: returns the square of a: :math:`a^2`
+
+    :param a: an input argument
+
+    :returns: a*a
+    """
+    return a * a


Test patch:
diff --git a/tests/test_bake_django.py b/tests/test_bake_django.py
--- a/tests/test_bake_django.py
+++ b/tests/test_bake_django.py
@@ -486,7 +486,7 @@ def test_baked_django_docs_with_how_to_contribute(cookies):
 
     contrib_path = (
         default_django.project_path
-        / "docs/source/how-tos/how-to-contribute.rst"
+        / "docs/source/how-to-guides/how-to-contribute.rst"
     )
     contrib_file = contrib_path.read_text().splitlines()
 
@@ -542,7 +542,7 @@ def test_baked_django_docs_without_how_to_contribute(cookies):
     )
 
     assert "how-to-contribute.rst" not in os.listdir(
-        non_default_django.project_path / "docs/source/how-tos"
+        non_default_django.project_path / "docs/source/how-to-guides"
     )
 
 
@@ -551,7 +551,8 @@ def test_baked_django_docs_with_how_to_index(cookies):
     default_django = cookies.bake()
 
     index_path = (
-        default_django.project_path / "docs/source/how-tos/index-how-to.rst"
+        default_django.project_path
+        / "docs/source/how-to-guides/index-how-to.rst"
     )
     index_file = index_path.read_text().splitlines()
 
@@ -564,8 +565,8 @@ def test_baked_django_docs_with_templates(cookies):
     """Test Django docs templates folder has been generated correctly."""
     default_django = cookies.bake()
 
-    assert "doc-templates" in os.listdir(
-        default_django.project_path / "docs/source"
+    assert "templates" in os.listdir(
+        default_django.project_path / "docs/source/documentation"
     )
 
 
@@ -602,7 +603,7 @@ def test_baked_django_docs_templates_index(cookies):
 
     index_path = (
         default_django.project_path
-        / "docs/source/doc-templates/index-templates.rst"
+        / "docs/source/documentation/templates/index-document-templates.rst"
     )
     index_file = index_path.read_text().splitlines()