improve documentation in properties and blacklists