finally start using MyST

Author: rmorshea

docs/source/conf.py

@@ -105,6 +105,22 @@
 
 # -- Extension Configuration ------------------------------------------------------
 
+# -- MyST Parser --
+
+myst_enable_extensions = [
+    # "amsmath",
+    "colon_fence",
+    # "deflist",
+    # "dollarmath",
+    # "html_admonition",
+    # "html_image",
+    # "linkify",
+    # "replacements",
+    # "smartquotes",
+    # "substitution",
+    # "tasklist",
+]
+
 # -- sphinx_panel --
 
 # Used to stop the extension from loading bootstrap twice since the `pydata_sphinx_theme`

docs/source/index.md

@@ -0,0 +1,36 @@
+# IDOM
+
+:::{toctree}
+:hidden:
+:caption: User Guide
+
+getting-started/index
+creating-interfaces/index
+adding-interactivity/index
+managing-state/index
+escape-hatches/index
+:::
+
+:::{toctree}
+:hidden:
+:caption: Other Resources
+
+understanding-idom/index
+contributing/index
+reference-material/index
+:::
+
+:::{toctree}
+:hidden:
+:caption: External Links
+
+Source Code <https://github.com/idom-team/idom>
+Community <https://github.com/idom-team/idom/discussions>
+Issues <https://github.com/idom-team/idom/issues>
+:::
+
+IDOM is a powerful Python web framework for building **interactive websites without
+needing a single line of Javascript**. It does this by breaking down complex
+applications into nestable and reusable chunks of code called
+{ref}`"components" <Your First Component>` that allow you to focus on what your
+application does rather then how it does it.