code change · fixAL Developmentofficial - Microsoftreviewed - checked by Opus

#2334 Handle app names with underscores correctly for reference documentation

AL-Go now handles underscores in app names consistently with AlDoc by preserving underscores instead of converting them to dashes when generating reference documentation paths.

Pull request · merged into main on 2026-07-31 by spetersenms · 3 files (+30 -1), 1 AL · fix · tier official · reviewed (checked by Opus)

What changed

  • Removed underscore-to-dash conversion logic that caused mismatches with AlDoc
  • App names like ‘Exclude_APIV1’ now preserve underscores in generated file paths
  • Added test coverage for underscore handling in app names
  • Fixes documentation generation failures due to path mismatch
  • Behaviour changes for users or extensions.

AL objects touched

  • Actions/BuildReferenceDocumentation/BuildReferenceDocumentation.HelperFunctions.ps1: modified, not in the BC? snapshot

Context

  • Systems: development, platform
  • From the description: “AL-Go replaced underscores like Replace('_', '-') meaning app names like _Exclude_APIV1_ becomes -Exclude-APIV1-. AlDoc doesn’t do this and allows underscores.”

Source: metadata of a merged pull request in microsoft/AL-Go (al-go): title, labels, changed paths and counts, with a summary in our words. No source text and no description beyond one short quote (D10, D61).