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

Signed-off-by: John Spray <john.spray@redhat.com>
Merge pull request #176 from ceph/wip-doc-howto

doc: add a note on how to update the API docs

Reviewed-by: Dan Mick <dan.mick@inktank.com>