[WIP][issue #369] documentation added