Looking really great to me so far! The layout seems really easy to follow, and it looks like you are planning on covering all the most important parts, without overwhelming the user with info!
I definitely agree with your plan to use examples as much as possible, I was just wondering about the practicalities of getting this working. In particular, do you have data that can be shared publicly for the examples?

operations.rst is likely to get rather large, given the agreed effectiveness of example code. To compensate for this I would quite like to introduce the Sphinx collapse directive, but I believe it would be the first third party extension we've used so I'm not sure if that's OK.

Any input @tkknight?

It's looking great! 👍

I believe I've addressed everyone's comments, either by making a change or by replying. I consider this ready to go.