go through docs again, fix header depths and add some new text