---
id: change/al-go/2301
type: change
title: "#2301 Provide package cache to aldoc when building reference documentation"
summary: The aldoc command now receives a populated package cache to resolve cross-module references in generated reference documentation, fixing unresolved links that occurred when building documentation for artifact-based apps.
tier: official
language: en
tags:
  - fix
  - main
system: development
review:
  state: reviewed
  by: opus
  at: "2026-10-08T02:12:20.334Z"
  flags: []
generated:
  at: "2026-10-08T01:26:53.141Z"
  pipeline: 0.2.0
  prompts:
    extract-change: 1
  input_hash: 6d8c1411a196b9118788638e58bd831c27b4f1d6
evidence:
  - kind: code
    url: https://github.com/microsoft/AL-Go/pull/2301
    title: "microsoft/AL-Go#2301: Provide package cache to aldoc when building reference documentation"
    date: "2026-07-17"
    commit: 6d8c1411a196b9118788638e58bd831c27b4f1d6
    t: null
    quote: null
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
  changes: []
number: 2301
repo: microsoft/AL-Go
source_id: al-go-prs
url: https://github.com/microsoft/AL-Go/pull/2301
kind: pr
base_branch: main
major: null
merged_at: "2026-07-17T11:52:16Z"
author: spetersenms
author_type: User
community_contribution: false
labels: []
change_class: code
change_kind: fix
behavior_change: true
breaking: false
files:
  count: 5
  additions: 73
  deletions: 11
  al: 2
apps: []
objects_touched: []
objects_unjoined:
  - path: Actions/BuildReferenceDocumentation/BuildReferenceDocumentation.HelperFunctions.ps1
    status: modified
    reason: not-in-snapshot
  - path: Actions/BuildReferenceDocumentation/BuildReferenceDocumentation.ps1
    status: modified
    reason: not-in-snapshot
obsoletions: []
backports: []
fixes_issues:
  - 2302
work_items: []
systems:
  - development
  - platform
quote: null
joined_against:
  major: null
  commit: null
---

# #2301 Provide package cache to aldoc when building reference documentation

> The aldoc command now receives a populated package cache to resolve cross-module references in generated reference documentation, fixing unresolved links that occurred when building documentation for artifact-based apps.

[Pull request](https://github.com/microsoft/AL-Go/pull/2301) · merged into `main` on 2026-07-17 by spetersenms · 5 files (+73 -11), 2 AL · fix · tier official · reviewed (checked by Opus)

## What changed

- aldoc now receives --packagecache parameter with all apps and their dependencies
- Fixes 'Referenced module not loaded' errors in reference documentation
- Resolves cross-module links in generated documentation
- Uses dependencies already computed by CalculateProjectsAndApps
- Addresses issue with artifact-based apps lacking default package cache
- Behaviour changes for users or extensions.

## AL objects touched

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

## Context

- Fixes: [#2302 [Bug]: AlDoc does not use --packagecache when building reference documentation](https://github.com/microsoft/AL-Go/issues/2302) (closed)
- Systems: development, platform

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).