Azure-sdk-for-java: Reference docs for packages that are no longer in preview should not be listed under the preview moniker

Created on 16 Dec 2020  路  5Comments  路  Source: Azure/azure-sdk-for-java

This is the landing page for Java API reference docs for packages that are in preview. Many of the these packages have moved out of preview and into GA. These should not appear here anymore. Found as part of #17304

image

Client Docs

All 5 comments

Please submit a PR that updates this file to remove the packages that are no longer GA. The link is to the part of the configuration that is for preview specifically.

I have filed an issue to cover this as part of the doc automation.

Thanks @scbedd
@samvaity, Can you please assign this issue to the release driver from your team?

@g2vinay Could you take a look at this.

@ramya-rao-a
Just to clarify, would this mean once a package has been GA'ed we should not be seeing that package in here at all?
However, we do support beta service releases and patch/stable releases.

For instance, FormRecognizer 3.1.0-beta.2 (beta) targets v2.1-preview.2 service version which is preview whereas the FormRecognizer 3.0.5 (stable) version still targets service version v2.0 under stable ref docs.

@samvaity Packages should show up here if there is a beta version that has not gone GA.
In your example of FR, it should appear both under preview and latest monikers. But say FR 3.1.0 goes GA in a few months, then you shouldnt see FR under the preview moniker until the next preview is out

@samvaity @ramya-rao-a
I'll take a look and submit a PR as @scbedd suggested above to update the file.

Was this page helpful?
0 / 5 - 0 ratings