add note on non-breakage of the API