compactify docstrings
let this be more succinct, following seanupton suggestion