AC0011 "Caption is missing" false positive for `HeadlinePart` page fields

[Arthurvdv]

From Microsoft Learn: https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-create-role-center-headline#in-development

There are only a few field properties that apply to fields that are used on a HeadlinePart type page, including Expression, Visible, ApplicationArea, Drilldown, and DrillDownPageID. All other properties are ignored.

Currently AC0011 raises a warning on page fields on HeadlinePart pages when the Caption property is missing, but the Caption property is ignored there.

---

Original Comments from StefanMaron/BusinessCentral.LinterCop#1212

---

Copied from original issue: StefanMaron/BusinessCentral.LinterCop#1212

[Arthurvdv]

Investigation Findings

Analyzed Microsoft's own Business Central source code for HeadlinePart page patterns:

Evidence from Microsoft's code (BCApps + ALAppExtensions)

Element	Caption set?	Example
Page object	✅ Yes	Caption = 'Headline';
Field controls	✅ Yes	Caption = 'Greeting headline';
Actions	✅ Yes	Caption = 'Refresh Now';
Groups	❌ No	Use ShowCaption = false; instead

Examples examined:

• Microsoft.SubscriptionBilling → Sub. Billing Headline RC (page 8086)
• Microsoft.Sustainability.RoleCenters → Headline Sustainability RC (page 6238)

Interpretation

The Microsoft docs state that only Expression, Visible, ApplicationArea, Drilldown, and DrillDownPageID apply to fields on HeadlinePart pages. Yet Microsoft's own code still sets Caption on these fields (likely for accessibility/metadata purposes rather than display).

Since the docs explicitly say Caption is ignored for HeadlinePart page fields, AC0011 firing there is a false positive: there's no user-facing benefit to requiring a property the runtime discards.

Proposed fix

Suppress AC0011 for field controls only inside HeadlinePart pages. Rationale:

• The page object itself should still have a Caption (Microsoft sets it, and it's used in navigation/metadata)
• Actions inside HeadlinePart pages should still have a Caption (used in action menus)
• Only field controls have their Caption explicitly ignored by the runtime per the docs

---

This comment was AI-generated based on codebase analysis.

[Arthurvdv]

@rvanbekkum, I could use your input on this. I'm a bit unfamiliar with HeadlinePart pages, so I could use your input on what we should suppress on the AC0011. Do I completely skip everything in a page of type HeadLinePart? 🤔