updated docs ready for public