contrib/apiage: Provide links to go docs for APIs

[anoopcs9]

fixes #592

[phlogistonjohn]

Did you try any of the links generated? I ask because I was under the impression that preview APIs would not show up on pkg.go.dev because there's no way to indicate to pkg.go.dev what build tags you want it to use. Therefore, it would not include anything that requires the ceph_preview build tag (see #601 ).

[ansiwen]

I ask because I was under the impression that preview APIs would not show up on pkg.go.dev because there's no way to indicate to pkg.go.dev what build tags you want it to use.

That's not just your impression but a fact, easily confirmed by for example searching in the rados docs for SetLocator, which is in preview since v0.15.0.

This makes #592 a bit moot tbh, since then there will be just a few links to deprecated functions, that we don't want that people use anyway.

[anoopcs9]

I ask because I was under the impression that preview APIs would not show up on pkg.go.dev because there's no way to indicate to pkg.go.dev what build tags you want it to use.

That's not just your impression but a fact, easily confirmed by for example searching in the rados docs for SetLocator, which is in preview since v0.15.0.

Correct. I should have asked first the very same question when I noticed this issue with doc generation while making the change.

This makes #592 a bit moot tbh, since then there will be just a few links to deprecated functions, that we don't want that people use anyway.

I agree.

[anoopcs9]

Following the discussion on #592 , I am taking the PR out.