Azure-sdk-for-net: [QUERY] Microsoft.Azure.Management.EventGrid - no stable version package?

[SeanFeldman]

Query/Question

All versions of the Microsoft.Azure.Management.EventGrid packages are published as previews.
That's an indication of a pre-released package. Is that so?

[SeanFeldman]

adding @jfggdl

[msftbot[bot]]

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @jfggdl.

[erich-wang]

un-assign myself as it is question to service team

[ahamad-MS]

Hello @SeanFeldman .. According to the link you provided, not all packages are previews. The latest "Stable" package is version 5.0.0 which corresponds to 2019-06-01 API version

--> Link: https://www.nuget.org/packages/Microsoft.Azure.Management.EventGrid/5.0.0

--> Release Notes
This corresponds to the 2019-06-01 API version which includes the following new functionalities: Domains, pagination and search filter for resources list operations, Service Bus Queue as destination, Advanced filtering and disallows usage of ‘All’ with IncludedEventTypes."

We are actively adding new features in preview which corresponds to 2020-04-01-preview hence the subsequent 5.X.X versions.

I am in the process of releasing next Stable API version (2020-06-01) as we speak. Swagger PR was just merged https://github.com/Azure/azure-rest-api-specs/pull/9629 . NET SDK is coming hopefully before end of this week (Version 6.0.0).

Does this answer your question/issue?

If not please provide additional info on the ask here. thanks

[SeanFeldman]

That makes sense. One challenge I'm having is the gap between NuGet package description and identifying what it refers to. For example:

5.3.2-preview says

This release corresponds to the 2020-04-01-Preview API version which includes the following new functionalities: Support for IP Filtering when publishing events to Domains and Topics, Partner Topics, System Topics, SKU, MSI and private link support.

5.3.1-preview says

This corresponds to the 2020-04-01-Preview API version which includes the following new functionality: Support for IP Filtering when publishing events to Domains and Topics, Partner topics, system topics, SKU, MSI and private link support.

5.3.0-preview says

This corresponds to the 2020-04-01-Preview API version which includes the following new functionality: Support for IP Filtering when publishing events to Domains and Topics, Partner topics, system topics, SKU, MSI and private link support.

Those are virtually identical. Is there a way to identify what is found in what release? Ideally, I'd like to see a table of released packages and features. If a preview is in a preview, it indicates so.

[ahamad-MS]

I understand the challenge. however, we need to follow the standard enforced by .net SDK team in versioning these packages. These packages are for the same preview API version (hence, the version includes -preview suffix). There is no new features added after 5.3.0-preview, and only few bug fixes and modifications to the existing features (hence we only increment the minor number). The text here is from the release note section of the project (again, enforced by .NET SDK authoring guidelines). I don't see a way to show a table in this nuget page itself given what we have to use.

What we can do is adding additional text if appropriate to the release notes that indicates that few bugs were added (even though the minor version update should suggest that). as for the table, I don't believe we can address it here in this context and I believe it will be hard to maintain this info somewhere else in our public documentation as it will eventually point to the nuget page.

If this satisfies your concern, please let us know to close this issue or let us know how we can address it better.

thanks

[SeanFeldman]

@ahamad-MS, one of the things that Azure SDK team is doing is having a changelog file which gets mentioned in the released packages which shows up in the NuGet package description for each version. That will be a good compromise. Can you do that?

And that will address my issue with how changes are communicated.

[ahamad-MS]

Thanks for the suggestion @SeanFeldman .. I took care of that as part of this PR for adding the new GA for management SDK. https://github.com/Azure/azure-sdk-for-net/pull/12576

HTH
thanks
Ashraf

[ahamad-MS]

@SeanFeldman
The new nuget for event grid management is out and addressed this issue too. Please refer to https://www.nuget.org/packages/Microsoft.Azure.Management.EventGrid/6.0.0 for the format.

Please let us know if this issue is addressed to close it.

thanks

[SeanFeldman]

This is great, thank you @ahamad-MS.

BTW, the changelog says

Cloud event V10 schema

Wouldn't that be v1.0? Too early for v10 🙂

[ahamad-MS]

thanks @SeanFeldman .. I will take care of the V10 typo.. thanks for letting me know.