I've had a lot of luck using sphinxcontrib-apidoc to automatically generate the API .rst files when the sphinx documentation is rendered and it has saved me a lot of time. I don't know if any other pangeo projects use it, but I'd be willing to add it here if no one has a problem with that.