Format annotated fields in records

[crogoz]

Before this PR

Annotated fields in records would be formatted the same as the annotated arguments of methods.
While this makes sense for annotated arguments of methods (reasoning in: here) for record parameters, it makes them hard to read:

public record QuoteRequest(
        @Schema(description = "US state of the product being quoted", example = "TX")
                RegulatoryState regulatoryState,
        @Schema(description = "Reason for a quote", example = "New Business") String amendmentReason,
        @Schema(description = "Type of quote being requested", example = "NEW_BUSINESS") QuoteType quoteType,
        @Schema(description = "Date the quoted changes become active", example = "2023-06-25")
                LocalDate quoteEffectiveDate,
)

After this PR

Fixes: #922
Fixes: #1292

public record QuoteRequest(
        @Schema(description = "US state of the product being quoted", example = "TX")
        RegulatoryState regulatoryState,

        @Schema(description = "Reason for a quote", example = "New Business")
        String amendmentReason,

        @Schema(
                description = "Type of quote being requested",
                example = "NEW_BUSINESS",
                somethingElse = "new",
                other = "my other long string")
        QuoteType quoteType,

        @Schema(description = "Date the quoted changes become active", example = "2023-06-25")
        LocalDate quoteEffectiveDate) {}

We are now reformatting the annotated parameters in records only following the rules:

1. if an annotated parameter is broken into multiple lines - add new lines (before & after but not the first/last line)
2. an annotated parameter is broken into multiple lines when the columnLimit would exceed 60.

==COMMIT_MSG==
Format annotated fields in records
==COMMIT_MSG==

Possible downsides?

[changelog-app]

Generate changelog in changelog/@unreleased

Type (Select exactly one)

• Feature (Adding new functionality)
• Improvement (Improving existing functionality)
• Fix (Fixing an issue with existing functionality)
• Break (Creating a new major version by breaking public APIs)
• Deprecation (Removing functionality in a non-breaking way)
• Migration (Automatically moving data/functionality to a new system)

Description

Format annotated fields in records

Check the box to generate changelog(s)

• Generate changelog entry

[changelog-app]

✅ Successfully generated changelog entry!

What happened?

Your changelog entries have been stored in the database as part of our migration to ChangelogV3.

Need to regenerate?

Simply interact with the changelog bot comment again to regenerate these entries.

[crogoz]

empty lines are kept in the output, so if people decide to add a line between the parameters, the formatter won't remove them

[crogoz]

new lines before & after the broken annotated field

[autorelease3]

Released 2.77.0