[WIP][issue #185] documentation has been written