From 5d1aa08f08eebf90bc5ea22560f82c353aed3a80 Mon Sep 17 00:00:00 2001
From: Brent Huisman <brenthuisman@users.noreply.github.com>
Date: Wed, 5 Jan 2022 12:41:01 +0100
Subject: [PATCH] Advertise GH Discussions for modelling (#1793)

---
 CONTRIBUTING.md         |  3 +--
 doc/contrib/index.rst   | 11 +++++++++++
 doc/index.rst           |  6 ++++++
 doc/modelling/index.rst | 10 ++++++++++
 4 files changed, 28 insertions(+), 2 deletions(-)
 create mode 100644 doc/modelling/index.rst

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index d9a8033e..3be4b679 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -15,7 +15,6 @@ where we have laid out how you can go about making your contribution.
 
 You can reach out in the following ways:
 
-* [Discussions](https://github.com/arbor-sim/arbor/discussions). Any questions or remarks regarding using Arbor
-for your research are welcome.
+* [Discussions](https://github.com/arbor-sim/arbor/discussions). We encourage you to use the discussion board for help with modelling. Any other questions or remarks regarding using Arbor for your research are of course also welcome.
 * [Gitter](https://gitter.im/arbor-sim/community). If you're interested in developing Arbor itself, get in touch on Gitter.
 * [Email](mailto:contact@arbor-sim.org).
diff --git a/doc/contrib/index.rst b/doc/contrib/index.rst
index 62b77007..72c1aca3 100644
--- a/doc/contrib/index.rst
+++ b/doc/contrib/index.rst
@@ -34,6 +34,17 @@ repository and nearly all of its infrastructure.
 -  Make sure you have a `GitHub
    account <https://github.com/signup/free>`__.
 
+.. _contribindex-model:
+
+Model
+~~~~~
+
+Sharing research and findings that used Arbor is the best contribution you can make to the project.
+
+- We encourage the use of our Github Discussions board for public discussions on modelling: `Github Discussions <https://github.com/arbor-sim/arbor/discussions>`_.
+
+- Users can share their models by adding them to the model collection on GitHub at `arbor-contrib <https://github.com/arbor-contrib/>`_.
+
 .. _contribindex-discuss:
 
 Start a discussion
diff --git a/doc/index.rst b/doc/index.rst
index 8ccc3e49..c03fecff 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -110,6 +110,12 @@ A full list of our software attributions can be found `here <https://github.com/
    concepts/spike_source_cell
    concepts/benchmark_cell
 
+.. toctree::
+   :caption: Modelling:
+   :maxdepth: 1
+
+   modelling/index
+
 .. toctree::
    :caption: File formats:
    :maxdepth: 1
diff --git a/doc/modelling/index.rst b/doc/modelling/index.rst
new file mode 100644
index 00000000..d2f0bdb4
--- /dev/null
+++ b/doc/modelling/index.rst
@@ -0,0 +1,10 @@
+.. _modelling-overview:
+
+Modelling
+=========
+
+Arbor is feature complete for real world modeling, and the user community is busy collaborating with us to build complex models. Best practices, tips, tricks and howtos will be documented here as the community gains experience.
+
+In the meantime, we encouraged the use of our Github Discussions board for public discussions on modelling: `Github Discussions <https://github.com/arbor-sim/arbor/discussions>`_.
+
+Under the `arbor-contrib <https://github.com/arbor-contrib/>`_ organisation, some users have already shared their models. You can peruse these at your leisure, and of course add yours if you like to share! `Please contact us <https://docs.arbor-sim.org/en/stable/contrib/index.html#get-in-touch>`_ to have your model added to our list.
-- 
GitLab