some structural changes to the doc