UK: add doc to document api changes