added documentation to EntityState