further documenting updates