Merge pull request #183 from NeuroML/pg_updates

Add step-by-step guides to GettingStarted page

source/Userdocs/GettingStarted.md

@@ -2,12 +2,28 @@
 # Getting started with NeuroML
 
 The best way to understand NeuroML is to work through NeuroML examples to see how they are constructed and what they can do.
-In this chapter, we will step through increasingly complex models to see how they are written and simulated using NeuroML.
+We present below a set of step-by-step guides to illustrate how models are written and simulated using NeuroML.
 
-To stress that **Python** is the suggested language for developing, simulating, and analysing NeuroML models, we will limit ourselves to the Python NeuroML tools only: {ref}`libNeuroML <libNeuroML>` and {ref}`pyNeuroML <pyNeuroML>`.
-You can learn more about the different NeuroML tools in their {ref}`specific sections <userdocs:software>`.
+<table>
+<tr>
+<td><a href="https://docs.neuroml.org/Userdocs/SingleNeuronExample.html"><img src="../_images/example-single-izhikevich2007cell-sim-v.png" height=150 title="Guide 1"/></a>&nbsp;&nbsp;</td>
+<td><a href="https://docs.neuroml.org/Userdocs/IzhikevichNetworkExample.html"><img src="../_images/example_izhikevich2007network_sim-spikes.png" height=150 title="Guide 2"/></a>&nbsp;&nbsp;</td>
+<td><a href="https://docs.neuroml.org/Userdocs/SingleCompartmentHHExample.html"><img src="../_images/HH_single_compartment_example_sim-v.png" height=150 title="Guide 3"/></a>&nbsp;&nbsp;</td>
+<td><a href="https://docs.neuroml.org/Userdocs/MultiCompartmentOLMexample.html"><img src="../_images/olm.cell.xy.png" height=150 title="Guide 4"/></a>&nbsp;&nbsp;</td>
+</tr>
+</table>
 
-You do not need to install any software on your computers to run the example code included in this chapter.
-Each example is followed by a [Jupyter notebook](https://jupyter.org/index.html) for you to experiment with.
-These can be run using the "launch" button in the top right hand corner.
-Please proceed to the first example section using the navigation button on the right below.
+
+| Link to guide    | Description | Model life cycle stages |
+| :------ | ----------- | ----------------------- |
+| [Guide 1](https://docs.neuroml.org/Userdocs/SingleNeuronExample.html) | Create and simulate a simple regular spiking Izhikevich neuron in NeuroML | Create, Validate, Simulate |
+| [Guide 2](https://docs.neuroml.org/Userdocs/IzhikevichNetworkExample.html) | Create a network of two synaptically connected populations of Izhikevich neurons  | Create, Validate, Visualise, Simulate |
+| [Guide 3](https://docs.neuroml.org/Userdocs/SingleCompartmentHHExample.html) | Build and simulate a single compartment Hodgkin-Huxley neuron | Create, Validate, Visualise, Simulate |
+| [Guide 4](https://docs.neuroml.org/Userdocs/MultiCompartmentOLMexample.html) | Create and simulate a multi compartment hippocampal OLM neuron | Create, Validate, Visualise, Simulate |
+| [Guide 5](https://docs.neuroml.org/Userdocs/OptimisingNeuroMLModels) | Optimise/fit NeuroML models to experimental data | Create, Validate, Simulate, Fit |
+| [Guide 6](https://docs.neuroml.org/Userdocs/CreatingNeuroMLModels.html\#converting-cell-models-to-neuroml-and-sharing-them-on-open-source-brain) | Guide to converting cell models to NeuroML and sharing them on Open Source Brain | Create, Validate, Simulate, Share |
+| [Guide 7](https://docs.neuroml.org/Userdocs/NML2_examples/NeuroML-DB.html) | Create novel NeuroML models from components on NeuroML-DB | Reuse, Create, Validate, Simulate |
+| [Guide 8](https://docs.neuroml.org/Userdocs/ExtendingNeuroMLv2.html\#example-lorenz-model-for-cellular-convection) | Extend NeuroML by creating a novel model type in LEMS  | Create, Simulate |
+
+
+You do not need to install any software on your computers to run many of the examples above. These examples are followed by a [Jupyter notebook](https://jupyter.org/index.html) for you to experiment with inside your browser ({ref}`more info <userdocs:usage:jupyterbooks>`).