BZ-1038214: adding documentation