Updating common and occurrence API docs, fixes http://dev.gbif.org/issues/browse/POR-1921