updating docs per @topgenorth comments [skip ci]