Improve discoverablility of network models in NEST docs

[jessica-mitchell]

This PR adds some additional links for network models in the models directory as well as in the examples

Output on Read the Docs: https://nest-simulator--3428.org.readthedocs.build/en/3428/index.html

[github-actions]

Pull request automatically marked stale!

[jessica-mitchell]

@jhnnsnk ping!

[jhnnsnk]

Instead of these cards, I suggest to start the page with the section "What we mean by models" that is currently further down (https://nest-simulator--3428.org.readthedocs.build/en/3428/models/index.html#what-we-mean-by-models). This section should also mention devices.

[jessica-mitchell]

This was discussed before, and the decision was made that we want to see the model selector near the top, so this was pushed further down. but maybe we can add a link at the top of the page with the cards like 'what's the difference?'

[jhnnsnk]

@jessica-mitchell I think for a new user it might be unclear that the model selector does not refer to network models after showing the cards of both. Yes, the "What's the difference?" already helps. In addition, I suggest to extend "Select a tag to display corresponding models." to "Select a tag to display corresponding neuron, synapse or device models."

[jhnnsnk]

Maybe "Neuron, synapse, and device models"?

[jessica-mitchell]

Technically the devices are not 'models', at least how I understand we define them. I did add some text below in the 'what we mean by models' section to explain a bit more. Hopefully without confusing it more.

[jhnnsnk]

Thanks a lot for this PR!
The card on large-scale models in Examples looks good to me.
I've left a comment with the suggestion to reorder the content of the Models page.
On the start page, would it be possible to add links to the examples or sections shown automatically one after the other?

[jessica-mitchell]

@jhnnsnk reminder

Thanks a lot for this PR! The card on large-scale models in Examples looks good to me. I've left a comment with the suggestion to reorder the content of the Models page. On the start page, would it be possible to add links to the examples or sections shown automatically one after the other?

If I understand what you mean, you want to be able to click on the image/text in the carousel and go straight to that example? I don't exactly remember, but there was an issue with doing that. I can look into it again

[jhnnsnk]

@jhnnsnk reminder

Thanks a lot for this PR! The card on large-scale models in Examples looks good to me. I've left a comment with the suggestion to reorder the content of the Models page. On the start page, would it be possible to add links to the examples or sections shown automatically one after the other?

If I understand what you mean, you want to be able to click on the image/text in the carousel and go straight to that example? I don't exactly remember, but there was an issue with doing that. I can look into it again

Yes, that's what I wanted to say. Thanks for looking into it.

[jessica-mitchell]

@jhnnsnk I added links to the images in the carousel, and modified the models/index page text a bit

[jhnnsnk]

@jhnnsnk I added links to the images in the carousel, and modified the models/index page text a bit

Looks and works great, thank you!

[jhnnsnk]

I left some tiny suggestions for text modifications, otherwise it's already great!

[jhnnsnk]

Lower-case "models"?

[jhnnsnk]

Maybe "Neuron, synapse, and device models"?