documenting new or semantics