small improvements in documentation and layout