documentation improvements by https://github.com/esquire-