Merge pull request #314 from adamtheturtle/rest-example-update

Fix a few nits with the sample

Author: adamtheturtle

sample/index.rst

@@ -3,14 +3,9 @@ Heading 1 with *bold*
 
 .. contents::
 
-.. rest-example::
-
-   .. toctree::
 
-      other
-
-Comment Support
-~~~~~~~~~~~~~~~~
+Comments
+~~~~~~~~
 
 .. rest-example::
 
@@ -325,21 +320,32 @@ This is useful for documentation that demonstrates how to write reStructuredText
 
 .. rest-example::
 
-   .. code-block:: python
+   .. rest-example::
+
+      .. code-block:: python
 
-      """Python code."""
+         """Python code."""
 
 
-      def greet(name: str) -> str:
-          """Return a greeting message."""
-          return f"Hello, {name}!"
+         def greet(name: str) -> str:
+             """Return a greeting message."""
+             return f"Hello, {name}!"
 
 
-      greet(name="World")
+         greet(name="World")
 
 Embed Blocks
 ~~~~~~~~~~~~
 
 Embed blocks can be created using the `sphinx-iframes <https://pypi.org/project/sphinx-iframes/>`_ extension.
 
 .. iframe:: https://www.youtube.com/embed/dQw4w9WgXcQ
+
+Sphinx ``toctree``\s are hidden
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. rest-example::
+
+   .. toctree::
+
+      other