Adding this here for additional discussion:
https://github.com/pymc-devs/pymc3/issues/2403
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 