updated docs for accurate data model