CORE-4446: added some documentation