Tewak the documentation and add some logging.