DOC: adopted comments to data types
WIP: rewriting of operations part