A few last doc comments and minor reordering for clarity
A few last doc comments and minor reordering for clarity

axw/juju,perrito666/juju,marcmolla/juju,mikemccracken/juju,mjs/juju,mjs/juju,mjs/juju,dimitern/juju,kat-co/juju,dooferlad/juju,mikemccracken/juju,anastasiamac/juju,macgreagoir/juju,mikemccracken/juju,kat-co/juju,reedobrien/juju,macgreagoir/juju,bz2/juju,dooferlad/juju,perrito666/juju,mikemccracken/juju,gabriel-samfira/juju,axw/juju,anastasiamac/juju,dooferlad/juju,AdamIsrael/juju,ericsnowcurrently/juju,bz2/juju,axw/juju,dimitern/juju,perrito666/juju,reedobrien/juju,perrito666/juju,alesstimec/juju,reedobrien/juju,mjs/juju,AdamIsrael/juju,bac/juju,dooferlad/juju,marcmolla/juju,AdamIsrael/juju,gabriel-samfira/juju,ericsnowcurrently/juju,bac/juju,bac/juju,frankban/juju,bac/juju,anastasiamac/juju,frankban/juju,gabriel-samfira/juju,ericsnowcurrently/juju,howbazaar/juju,dimitern/juju,marcmolla/juju,mjs/juju,waigani/juju,kat-co/juju,howbazaar/juju,anastasiamac/juju,ericsnowcurrently/juju,gabriel-samfira/juju,waigani/juju,howbazaar/juju,howbazaar/juju,alesstimec/juju,bz2/juju,alesstimec/juju,AdamIsrael/juju,bz2/juju,dimitern/juju,kat-co/juju,alesstimec/juju,frankban/juju,axw/juju,bz2/juju,kat-co/juju,waigani/juju,axw/juju,perrito666/juju,macgreagoir/juju,gabriel-samfira/juju,reedobrien/juju,howbazaar/juju,frankban/juju,macgreagoir/juju,reedobrien/juju,anastasiamac/juju,bac/juju,marcmolla/juju,waigani/juju,dooferlad/juju,alesstimec/juju,mjs/juju,frankban/juju,mikemccracken/juju,mjs/juju,dimitern/juju,ericsnowcurrently/juju,marcmolla/juju,macgreagoir/juju