missing docs for rule 1047 XmsEnumChanged

Open

#282 opened on Nov 13, 2023 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty: 2/5
Estimated time: 1-3 hours
Newbie friendliness: 45/100

Issue type: Documentation
Clarity: Mostly clear
Activity status: Stale
Tech stack: csharp
Domain: documentation

Research direction

Start with the missing docs/rules/1047.md page and the rule output in the issue, especially code XmsEnumChanged and its message. Done means the rule documentation exists at that path and the reported docUrl no longer returns a 404.

Written by the indexing model from the issue text.

Description

docUrl of https://github.com/Azure/openapi-diff/tree/master/docs/rules/1047.md ends up as 404 File not found.

  {
    "id": "1047",
    "code": "XmsEnumChanged",
    "message": "The new version has a different x-ms-enum 'name' than the previous one.",
    "old": {
      "ref": "file:///C:/Users/cataggar/ms/azure-rest-api-specs-pr/specification/vmware/resource-manager/Microsoft.AVS/stable/2023-03-01/vmware.json#/definitions/VirtualMachineRestrictMovement/properties/restrictMovement",
      "path": "definitions.VirtualMachineRestrictMovement.properties.restrictMovement",
      "location": "file:///C:/Users/cataggar/ms/azure-rest-api-specs-pr/specification/vmware/resource-manager/Microsoft.AVS/stable/2023-03-01/vmware.json:7571:9"
    },
    "new": {
      "ref": "file:///C:/Users/cataggar/ms/azure-rest-api-specs-pr/specification/vmware/resource-manager/Microsoft.AVS/preview/2023-09-01-preview/vmware.json#/definitions/VirtualMachineRestrictMovement/properties/restrictMovement",
      "path": "definitions.VirtualMachineRestrictMovement.properties.restrictMovement",
      "location": "file:///C:/Users/cataggar/ms/azure-rest-api-specs-pr/specification/vmware/resource-manager/Microsoft.AVS/preview/2023-09-01-preview/vmware.json:9503:9"
    },
    "type": "Error",
    "docUrl": "https://github.com/Azure/openapi-diff/tree/master/docs/rules/1047.md",
    "mode": "Update"
  },

Dominant language: C#
Stars: 290
Forks: 50
Avg merge: 2d 21h
Merged PRs (30d): 10

Contributor guide

Open the contributing guide

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

Similar issues

Add more to the documentation Open

:watch: Not Triaged dotnet-fsharp/svc

Difficulty 1/5 Under an hour Newbie friendliness 90/100

dotnet/docs#56209 · Opened Sep 22, 2026
WebPubSubServiceClient.GetClientAccessUri (sync) drops the groups argument on the TokenCredential path Open

Client customer-reported needs-team-attention question Service Attention WebPubSub

Difficulty 2/5 1-3 hours Newbie friendliness 76/100

Azure/azure-sdk-for-net#63292 · 3 comments · 1 reaction · Opened Sep 22, 2026
Add support for WebRequestMethod QUERY Open

Issue-Enhancement Needs-Triage

Difficulty 1/5 Under an hour Newbie friendliness 86/100

PowerShell/PowerShell#28061 · 2 reactions · Opened Sep 22, 2026
Update Microsoft.Identity.Web dependency Open

dependencies needs-team-triage server-Azure.Mcp

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

microsoft/mcp#3752 · 1 comment · Opened Sep 22, 2026
Drop INCLUDES versioning from SignalR Hubs article Open

aspnet-core/svc aspnetcore-signalr/subsvc doc-enhancement Pri2 SignalR

Difficulty 1/5 Under an hour Newbie friendliness 88/100

dotnet/AspNetCore.Docs#37729 · Opened Sep 22, 2026

More C# issues