Document the semantics of annotation ordering
It's important to specify the way that annotations relate to the
characters of the underlying string and each other.
Along the way, it's also worth explaining the behaviour of the internal
functions _clear_annotations_in_region! and _insert_annotations!.
