bson_iter_value returns a const bson_value_t, a type representing any BSON value, from the current field pointed to by the bson_iter_t. However, the documentation fails to state that if the bson_iter_t is further modified, the bson_value_t is invalidated. This has caught us before, let's document so we don't forget.