Docs wishlist

[brenthuisman]

This Issue keeps track of open but identified TODOs for the documentation. A docs wishlist! Please keep issue current (edit this text) so we keep track of things we know need to be corrected but are too small for a separate issue and/or cannot be handled right now.

• [ ] Cell Mechanism concepts page: include listing of default mechanisms, their name/tag and description, enumeration of parameters and their role/meaning/explanation wherever not absolutely trivial.
  • e.g. gnabar == maximum possible sodium conductance
• [x] A concepts page that describes probes and samplers. (See #474)
• [ ] C++ API documentation for recipe is out of date #1080
• [x] remove em from custom css, and change all terms to :term:terms
• [ ] C++ API for mechanism_catalogue
• [ ] C++ API for morphology
• [x] C++ API for segment_tree
• [ ] C++ API for regions and locsets
• [ ] C++ cable_cell page split and reorganize
• [ ] C++ event_generator docs
• [x] Python event_generator docs
• [x] Python API for cable_cell
• [x] Python API for morphology
• [x] Python API for gap_junctions (incomplete)
• [ ] Python API for iclamp
• [x] Python API for spike_detector
• [ ] Python API for initial_ion_data
• [x] Python API for cable_global_properties
• [x] Concepts/cable_cell/decorations/place: fill the gaps
• [x] Contribution: finish docs howto
• [x] Contribution: add example howto?
• [x] Contribution: add test howto
• [x] Developer docs, Arbor internals.

Out of scope for this issue

• New tutorials, moved here: https://github.com/arbor-sim/arbor/issues/1369
• Use docstrings on user facing API: makes them guaranteed up-to-date, testable. #1259, #1240

Edits

• @thorstenhater add event_generator

[thorstenhater]

Hi @brenthuisman ,

could you update the progress here?

[brenthuisman]

Updated.