# Explanation

These documents explain the design decisions behind cogpy. They help you
understand *why* the library works the way it does, not *how* to use it
(see {doc}`/tutorials/index` and {doc}`/howto/index` for that).

For formal specifications and schema definitions, see {doc}`/reference/index`.

```{toctree}
:maxdepth: 1

architecture
data-model
spectral-conventions
detection-framework
preprocessing-pipeline
primitives
package-map
preprocess/channel_feature
plot/ieeg-toolkit
plot/topomap
```