Documentation for recording spike times is obtuse

[WillemWybo]

Describe the flaw
The main spike_recorder documentation page doesn't mention that there is an 'events' attribute containing the spike times. I had to click through two times to backends to find it here.

Suggest an improvement
Describe the attribute on the main docs page

Supporting materials
https://nest-simulator.readthedocs.io/en/latest/models/spike_recorder.html

[heplesser]

In context withe readers for our file output, I created some documentation of the file format here:
NeuralEnsemble/python-neo#1097 (review)

It applies correspondingly to the entries of the events dictionary and may be useful as a starting point for better documentation.

[github-actions]

Issue automatically marked stale!