Major overhaul of front end docs and fix to sphinx build