Update model docs to reStructuredText format

[jessica-mitchell]

This PR stems from the user doc extractor from @jougs and @terhorstd (Note #1355 probably should be merged first)

It removes the doxygen style format and replaces it with reStructuredText in the models/ directory.
I also removed the SLI examples.

Note that now we've lost the automated linking (like in the See Also section) that breathe used to do.

see the current output here: https://nest-test.readthedocs.io/en/update_models_rst_format/from_cpp/index.html

[jougs]

@jessica-mitchell: I had a meeting with @sarakonradi yesterday, discussing what I would like to have changed in this one and we agreed that she will make the changes and send you a corresponding PR instead of me doing a review at this point. Once that happened, I'll have another closer look.

[jougs]

Can you please pull upstream/master again? Since the merge of #1245, there's a new MUSIC proxy whose documentation also needs conversion to RST. Thanks!

[heplesser]

@jessica-mitchell I just sent you a PR towards your branch to resolve the merge conflict.

[heplesser]

@jessica-mitchell This did not work quite as well as I had hope. Note that the iaf_chxk_2008 model has moved to the precise directory per #1396. Could you pull the most recent master into your branch? We can then sort out the model documentation to make sure that your changes to formatting and my changes to content get nicely combined.

[sarakonradi]

@heplesser The MUSIC proxy documentation also needs to be converted to RST. I assume that, once the iaf_chxk_2008 merge conflict is solved, we will send a separate PR to @jessica-mitchell?

[jessica-mitchell]

@heplesser @sarakonradi Merged master, seems like conflicts are gone :)

[sarakonradi]

#1484 updates the rate-based models' documentation and should be taken into account.

[heplesser]

#1484 updates the rate-based models' documentation and should be taken into account.

@jessica-mitchell #1484 is merged into master now, so you could pull it directly in here. This may explain the new merge conflicts.

[sarakonradi]

Yes @heplesser, that definitely explains the new merge conflicts.

We should make sure the rate-based models and MUSIC proxy files are properly converted to RST given the recent updates (#1484, #1245).

[sarakonradi]

@jougs I discussed this PR with @terhorstd in our recent doc meeting. We thought that, other than fixing the merge conflicts, it might make more sense to bring #1374 to an end soon and to address the improvement of the MUSIC proxy and rate-based models in a follow-up PR straight afterwards. What do you think?

Otherwise, I am happy sending another PR to @jessica-mitchell!

[heplesser]

@sarakonradi I think disentangling PRs is a good idea. Release early, release often, as they say in the agile world ;).

[heplesser]

Closed, replaced by #1530.