improved documentation, fixed bullet lists