doc: add a note on how to update the API docs

Signed-off-by: John Spray <john.spray@redhat.com>