add subsections inside community section (#5782)

pymc-devs · May 19, 2022 · 2536920 · 2536920
1 parent 82f70fc
commit 2536920
Show file tree

Hide file tree

Showing 4 changed files with 22 additions and 2 deletions.
diff --git a/docs/source/community.md b/docs/source/community.md
@@ -27,4 +27,17 @@ Learn how the PyMC project is governed and how to become a member of PyMC [here]
 
 ## Code of Conduct
 
-In order to foster a welcoming environment, participation in our project and community is guided by this [code of conduct](https://github.com/pymc-devs/pymc/blob/main/CODE_OF_CONDUCT.md).
+In order to foster a welcoming environment, participation in our project and community is guided by the {ref}`code_of_conduct`.
+
+:::{toctree}
+:caption: Discourse resources
+
+community/how_to_ask_on_discourse
+:::
+
+:::{toctree}
+:caption: General resources
+
+community/code_of_conduct
+Blog <https://www.pymc.io/blog.html>
+:::
diff --git a/docs/source/community/code_of_conduct.md b/docs/source/community/code_of_conduct.md
@@ -0,0 +1,3 @@
+(code_of_conduct)=
+```{include} ../../../CODE_OF_CONDUCT.md
+```
diff --git a/docs/source/community/how_to_ask_on_discourse.md b/docs/source/community/how_to_ask_on_discourse.md
@@ -0,0 +1,4 @@
+(how_to_ask_on_discourse)=
+# How to ask a question on Discourse
+
+**Placeholder page**
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -249,7 +249,7 @@
 }
 # this controls which sidebar sections are available in which pages. [] removes the left sidebar
 html_sidebars = {
-    "community": ["twitter"],
+    "community": ["sidebar-nav-bs.html", "twitter"],
     "**": ["sidebar-nav-bs.html"],
 }