I'm more than happy to hack some restructured text. How best to submit a patch to a doc? I'm not going to take the time to improve unless I know how to get my change included. I'd be hacking the 2.7 branch, since that's the version I seem to be working in. Hopefully, 3 will start getting more traction in real world dev.ops. environments soon.