Issue: Numpy style docstrings?

Adding this here for additional discussion:

I’ll link the PR in a few minutes when it is made, but there’s some tension here between strong linting and automatically enforcing good documentation and fast iteration. I’ll also write more about what I think the best thing is :slight_smile: