SpikeyCNS/spikey

Redo docstrings checklist.

Closed this issue · 0 comments

Format

"""
Short description

Parameters
------------
param: type
    Description of variable
...

Returns
---------
type Description of return

Usage
-------
```python
...
\```
"""

If is an ndarray, use ndarray[dim1, dim2](dtype if applicable).

  • Not much of existing documentation is this specific but should be moving forward.

Top of file docstring be copy of most relevant object docstring.

Doc Checklist (All in one PR)

  • Setup.py description outdated.
  • Setup.py version "DEVELOPMENT" overwritten in main, remove but test install after.
  • core/
  • experiments/
  • games/RL/
  • games/MetaRL/
  • logging/
  • viz/
  • meta/
  • snn/input
  • snn/modifier
  • snn/neuron
  • snn/readout
  • snn/reward
  • snn/synapse
  • snn/weight - Note matrix must be ma.
  • snn/network - Clear there is multiple network options.
  • Link to relevant sections of readme in callback, trainingloop, logger, reader, ...
  • np.ndarray type hints -> specific ndarray dtypes

Type Hint Checklist (All in one PR)

  • core/
  • experiments/
  • games/RL/
  • games/MetaRL/
  • logging/
  • viz/
  • meta/
  • snn/input
  • snn/modifier
  • snn/neuron
  • snn/readout
  • snn/reward
  • snn/synapse
  • snn/weight - Note matrix must be ma.
  • snn/network - Clear there is multiple network options.