improvements to site documentation - pair programmed with Schnikeroo