Skip to content

Reenable Azure.Messaging.EventGrid.SystemEvents MSDocs publishing #45032

Open
@JimSuplizio

Description

@JimSuplizio

This is the explanation from the docs team:
Current ops build is failing on main branch of repo azure-docs-sdk-dotnet, this is caused by the newly introduced package "Azure.Messaging.EventGrid.SystemEvents" in azure-dotnet-preview.
https://github.com/Azure/azure-docs-sdk-dotnet/blob/f577862a0098cf76b5591b4de76247cadd249213/bundlepackages/azure-dotnet-preview.csv#L59

The root cause is:
There is already an MediaJobErrorCategory enum in the package NuGet Gallery | Azure.Messaging.EventGrid 4.24.0
But in NuGet Gallery | Azure.Messaging.EventGrid.SystemEvents 1.0.0-beta.1 it becomes a struct.
Both share the same DocId: T:Azure.Messaging.EventGrid.SystemEvents.MediaJobErrorCategory and mdoc cannot identify them.
The xml file generated becomes mixed and unpredictable and now causes build issue.

Disabling this is trivial, it's the matter of adding skipPublishDocMs: true to the artifact in sdk/eventgrid/ci.yml. Reenabling will simply be removing this line. I'm assigning this issue to myself since the docs team will let me know when this is fixed.

This is the issue in azure-sdk-for-net tracking the library changes.

This is the issue tracking the failure in docs.

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

Status

📋 Backlog

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions