Skip to content

#93 - Generate docs source links in one build - #150

Closed
esitarz wants to merge 1 commit into
masterfrom
fix/93-docs-build-links
Closed

esitarz wants to merge 1 commit into
masterfrom
fix/93-docs-build-links

Conversation

@esitarz

@esitarz esitarz commented Sep 26, 2026

Copy link
Copy Markdown
Contributor

Summary

  • TypeDoc only adds a GitHub "Defined in" link when git ls-files casing matches the TypeScript filename. src/configuration.ts was tracked in a different case than Configuration.ts, so those links stayed plain text no matter how many times docs were built.
  • npm run build:docs now fails if any generated page still has an unlinked "Defined in" line.
  • A clean docs directory, one npm run build:docs, and a second TypeDoc run produce the same Resources.Addresses.html. The Addresses page from Need to run build twice in order to generate docs links #93 already has GitHub links on the first run with TypeDoc 0.28.20.

Closes #93

Test plan

  • Delete docs/, run npm run build:docs once, and confirm the check reports GitHub source links
  • Run TypeDoc again and confirm docs/classes/Resources.Addresses.html and docs/classes/Resources.Configuration.html are unchanged
  • Confirm Resources.Configuration.html "Defined in" lines are GitHub links to src/Configuration.ts
  • npx jest --config tests/config/server.config.js tests/configuration.test.ts

TypeDoc omits the GitHub "Defined in" link when the git path does
not match the TypeScript filename. src/configuration.ts was tracked
with different casing than Configuration.ts, so those links stayed
plain text. Match the casing, and fail the docs build if any source
line is still unlinked.

Closes #93
@esitarz esitarz changed the title Generate docs source links in one build #93 - Generate docs source links in one build Sep 28, 2026
@esitarz esitarz mentioned this pull request Sep 28, 2026
6 of 7 tasks
@esitarz esitarz mentioned this pull request Oct 14, 2026
2 of 4 tasks
@esitarz esitarz closed this Oct 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Need to run build twice in order to generate docs links

1 participant