we should add documentation for:
- how does it work, what are the mechanisms and how to configure.
- a working simple example.
- documentation on every in-tree plugin with clear explanation what its expected input and output.
the above may include a new well lit path
we should add documentation for:
the above may include a new well lit path