---
id: change/al-go/2334
type: change
title: "#2334 Handle app names with underscores correctly for reference documentation"
summary: 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.
tier: official
language: en
tags:
  - fix
  - main
system: development
review:
  state: reviewed
  by: opus
  at: "2026-10-08T02:10:29.855Z"
  flags: []
generated:
  at: "2026-10-08T01:26:53.141Z"
  pipeline: 0.2.0
  prompts:
    extract-change: 1
  input_hash: 38f971084e949653850a8bba31c7a94ab31a0a7c
evidence:
  - kind: code
    url: https://github.com/microsoft/AL-Go/pull/2334
    title: "microsoft/AL-Go#2334: Handle app names with underscores correctly for reference documentation"
    date: "2026-07-31"
    commit: 38f971084e949653850a8bba31c7a94ab31a0a7c
    t: null
    quote: AL-Go replaced underscores like `Replace('_', '-')` meaning app names like `_Exclude_APIV1_` becomes `-Exclude-APIV1-`. AlDoc doesn't do this and allows underscores.
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
  changes: []
number: 2334
repo: microsoft/AL-Go
source_id: al-go-prs
url: https://github.com/microsoft/AL-Go/pull/2334
kind: pr
base_branch: main
major: null
merged_at: "2026-07-31T08:21:37Z"
author: spetersenms
author_type: User
community_contribution: false
labels: []
change_class: code
change_kind: fix
behavior_change: true
breaking: false
files:
  count: 3
  additions: 30
  deletions: 1
  al: 1
apps: []
objects_touched: []
objects_unjoined:
  - path: Actions/BuildReferenceDocumentation/BuildReferenceDocumentation.HelperFunctions.ps1
    status: modified
    reason: not-in-snapshot
obsoletions: []
backports: []
fixes_issues: []
work_items: []
systems:
  - development
  - platform
quote: AL-Go replaced underscores like `Replace('_', '-')` meaning app names like `_Exclude_APIV1_` becomes `-Exclude-APIV1-`. AlDoc doesn't do this and allows underscores.
joined_against:
  major: null
  commit: null
---

# #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](https://github.com/microsoft/AL-Go/pull/2334) · 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).