updated docs using modern docco