improve documentation (issue: #621)