From 2917d9a9ebd27a231870aafb019111f4051b8dd8 Mon Sep 17 00:00:00 2001
From: Philipp Temminghoff <philipptemminghoff@googlemail.com>
Date: Thu, 21 Sep 2023 21:03:35 +0200
Subject: [PATCH] chore: docs

---
 mknodes/manual/navs_section.py | 20 +++++++++++++++-----
 mknodes/pages/mkpage.py        |  2 +-
 2 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/mknodes/manual/navs_section.py b/mknodes/manual/navs_section.py
index 3a71a0b0..3f449ed2 100644
--- a/mknodes/manual/navs_section.py
+++ b/mknodes/manual/navs_section.py
@@ -164,7 +164,6 @@ def create_mkmodulepage_page(page: mk.MkPage):
 
 @pages_nav.route.page("Adding to MkPages", hide="toc", status="new")
 def create_adding_to_mkpages_page(page: mk.MkPage):
-    """Create the "Adding to MkPages" MkPage and attach it to given MkNav."""
     page += mk.MkAdmonition("You can add other MkNodes to a page sequentially.")
     page += "Adding strings also works, they get converted to MkText nodes."
     page += "### ...and text starting with # will become a MkHeader."
@@ -180,8 +179,6 @@ def create_adding_to_mkpages_page(page: mk.MkPage):
     description="Description",
 )
 def create_metadata_page(page: mk.MkPage):
-    """Create the "Metadata" MkPage and attach it to given nav."""
-    # page.metadata is a dataclass, we can prettyprint these with MkPrettyPrint.
     page += METADATA_TEXT
     page += mk.MkDocStrings(
         metadata.Metadata,
@@ -192,8 +189,22 @@ def create_metadata_page(page: mk.MkPage):
     )
 
 
+@pages_nav.route.page("Templates", hide="toc", status="new")
+def create_template_page(page: mk.MkPage):
+    page += "The page template can be edited easily via the 'template' attribute."
+    code = "information = 'You can even put MkNodes here!'"
+    text = (
+        'page.template.announce_block.content = mk.MkMetadataBadges(typ="classifiers")\n'
+        "page.template.footer_block.content = mk.MkProgressBar(50)\n"
+        f'page.template.tabs_block.content = mk.MkCode(f"{code}")'
+    )
+    page += mk.MkCode(text)
+    page.template.announce_block.content = mk.MkMetadataBadges(typ="classifiers")
+    page.template.footer_block.content = mk.MkProgressBar(50)
+    page.template.tabs_block.content = mk.MkCode(f"{code}")
+
+
 def create_mkdefaultwebsite_section(nav: mk.MkNav):
-    """Create the "MkDefaultWebsite" sub-MkNav and attach it to given nav."""
     proj = Project.for_path("https://github.com/mkdocstrings/mkdocstrings.git")
     website_nav = mk.MkDefaultWebsite(section="MkDocStrings", project=proj)
     nav += website_nav
@@ -201,7 +212,6 @@ def create_mkdefaultwebsite_section(nav: mk.MkNav):
 
 @nav.route.nav("MkDoc")
 def create_mkdoc_section(nav: mk.MkNav):
-    """Create the "Metadata" sub-MkNav and attach it to given nav."""
     nav = nav.add_nav("MkDoc")
 
     page = nav.add_index_page(hide="toc", icon="api")
diff --git a/mknodes/pages/mkpage.py b/mknodes/pages/mkpage.py
index 791f0e29..01ee89c3 100644
--- a/mknodes/pages/mkpage.py
+++ b/mknodes/pages/mkpage.py
@@ -168,7 +168,7 @@ def icon(self, value: str):
         self._metadata.icon = value
 
     @property
-    def template(self) -> pagetemplate.PageTemplate | None:
+    def template(self) -> pagetemplate.PageTemplate:
         return self._template
 
     @template.setter