"Services MUST increment their version number in response to any breaking API change. See the following section for a detailed discussion of what constitutes a

"Services MUST increment their version number in response to any breaking API change. See the following section for a detailed discussion of what constitutes a breaking change. Services MAY increment their version number for nonbreaking changes as well, if desired.” Of course you want to mention that a new field was added and what it is for, but why do you need a big notice? Your clients should just continue to work.