improved documentation
...