Some kind of detailed explanation of the purpose of each layer inside the public API (Repository, Services, Persistence Handlers, Gateways, SPI, etc...) and their interactions would be useful to help debugging and contributing to the kernel.