further improvements of documentation