Code review comment for lp:~vishvananda/nova/lp710959

This looks good but we could use some more detailed doc strings detailing what the higher level interactions here are. There are lots of notes but nothing that lets the reader infer a bigger picture.