Needs developer docs describing the organizing principles, supported feature set, implementation at a hight level

[AWinterman]

This source code is hard to grock. Following a concept to its conclusion through the source is challenging.