Added some docs instead in https://github.com/ezsystems/ezpublish-kernel/commit/8c162fc8bdb08105cf121dd3d5a4e5e7f3fa322a :)