I agree. We can document that. Probably also can make this private - even if they do want to change the behavior they can just set the attributes.