Advertise GH Discussions for modelling (#1793)

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).

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

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

doc/modelling/index.rst

+.. _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.