updating docs. Refs #2