It's probably good enough to just add some documentation that summarizes this discussion.