Skip to content

[PS ManagedServices] Add breaking change announcement #27957

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

JoyerJin
Copy link
Contributor

Description

Add breaking change announcement for #27929

Mandatory Checklist

  • SHOULD update ChangeLog.md file(s) appropriately
    • Update src/{{SERVICE}}/{{SERVICE}}/ChangeLog.md.
      • A snippet outlining the change(s) made in the PR should be written under the ## Upcoming Release header in the past tense.
    • Should not change ChangeLog.md if no new release is required, such as fixing test case only.
  • SHOULD regenerate markdown help files if there is cmdlet API change. Instruction
  • SHOULD have proper test coverage for changes in pull request.
  • SHOULD NOT adjust version of module manually in pull request

@Copilot Copilot AI review requested due to automatic review settings June 13, 2025 08:17
Copy link

Thanks for your contribution! The pull request validation has started. Please revisit this comment for updated status.

@JoyerJin JoyerJin added the Breaking Change Preannounce This PR adds preannouncement about upcoming breaking change label Jun 13, 2025
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR adds breaking change announcements to notify users of type changes from Fixed Array to List across the module. Key changes include updates to the changelog, module metadata, cmdlet annotations, and documentation reflecting the breaking changes.

  • Updates in ChangeLog.md with new breaking change messages.
  • Adjustments to the Az.ManagedServices.psd1 file for module versioning and file path fixes.
  • New breaking change annotations in cmdlets and updated documentation in README.md.

Reviewed Changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
src/ManagedServices/ManagedServices/ChangeLog.md Added breaking change messages to announce type changes.
src/ManagedServices/ManagedServices/Az.ManagedServices.psd1 Updated generated date, required module version, and file path style.
src/ManagedServices/ManagedServices.sln Added new project configurations and modified project references.
src/ManagedServices/ManagedServices.Autorest/resources/README.md Added documentation regarding resource files.
src/ManagedServices/ManagedServices.Autorest/generate-info.json Updated generate_Id value.
src/ManagedServices/ManagedServices.Autorest/docs/Az.ManagedServices.md Updated Module Guid.
src/ManagedServices/ManagedServices.Autorest/custom/New-AzManagedServicesEligibleAuthorizationObject.ps1 Added a CmdletBreakingChange attribute for a breaking change.
src/ManagedServices/ManagedServices.Autorest/README.md Updated breaking change directives and messages in the module documentation.
src/ManagedServices/ManagedServices.Autorest/Properties/AssemblyInfo.cs Added assembly metadata.
Comments suppressed due to low confidence (2)

src/ManagedServices/ManagedServices.Autorest/README.md:73

  • For clarity and grammatical accuracy, consider changing 'have changed' to 'has changed' in the breaking change description.
change-description: "The type of property 'DelegatedRoleDefinitionId' have changed from Fixed Array to List. The types of property 'JustInTimeAccessPolicyManagedByTenantApprover' have changed to List."

src/ManagedServices/ManagedServices/ChangeLog.md:22

  • [nitpick] The phrase 'fixing one object to List' is ambiguous. Consider clarifying the message to precisely indicate what type change is being announced.
* Added breaking change announcement for fixing one object to List.

subject: RegistrationAssignment
set:
breaking-change:
change-description: "The types of property 'Authorization' and 'EligibleAuthorization' have changed to 'List'."
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
change-description: "The types of property 'Authorization' and 'EligibleAuthorization' have changed to 'List'."
change-description: "The types of property 'Authorization' and 'EligibleAuthorization' will be changed to 'List'."

subject: RegistrationDefinition
set:
breaking-change:
change-description: "The types of the properties 'DelegatedRoleDefinitionId' and 'JustInTimeAccessPolicyManagedByTenantApprover' will be changed to List."
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
change-description: "The types of the properties 'DelegatedRoleDefinitionId' and 'JustInTimeAccessPolicyManagedByTenantApprover' will be changed to List."
change-description: "The types of the properties 'DelegatedRoleDefinitionId' and 'JustInTimeAccessPolicyManagedByTenantApprover' will be changed to 'List'."

@@ -26,6 +26,7 @@
#>
function New-AzManagedServicesEligibleAuthorizationObject {
[OutputType('Microsoft.Azure.PowerShell.Cmdlets.ManagedServices.Models.Api20200201Preview.EligibleAuthorization')]
[Microsoft.Azure.PowerShell.Cmdlets.ManagedServices.Runtime.CmdletBreakingChange("15.0.0", "9.0.0", "2025/11/03", ChangeDescription="The type of property 'DelegatedRoleDefinitionId' will be changed from Fixed Array to List.")]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should be updated to ""The type of the property 'DelegatedRoleDefinitionId' will be changed to 'List'."" to make them consistent. One question, is 'DelegatedRoleDefinitionId' a property or parameter?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Breaking Change Preannounce This PR adds preannouncement about upcoming breaking change
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants