Add information about OSB API operations

[pmorie]

@onyiny-ang, do you think this is useful information to add?

[onyiny-ang]

@pmorie Yes, I think your additions make the comments clearer and direct links to the applicable docs are especially helpful :+1: lgtm