more improvements in documentation