Document atomicity requirements and example usage when operating on the annotation structure.

While this covers intended behavior given the current structure design,
this should not be considered a final implementable target.

Issue: PLCR-527