DOC: General improvements and corrections to new_instrument
DOC: General improvements and corrections to new_instrument

(cherry picked from commit de4eb93daadd08acab31a04d1e304ff0c69a6874)

rstoneback/pysat