github-starred/actual
2
0
Fork 0
mirror of https://github.com/actualbudget/actual.git synced 2026-11-13 17:43:23 -06:00
Code Issues 3.0k Packages Projects Releases 58 Wiki Activity

[GH-ISSUE #8178] [Docs] - Broken link to migration/nynab.md in API docs breaks the docs site build #117687

New Issue
Closed
opened 2026-06-11 13:08:20 -05:00 by GiteaMirror · 1 comment
GiteaMirror commented 2026-06-11 13:08:20 -05:00
Owner
Copy Link
Copy Source

Originally created by @augustocbx on GitHub (Jun 10, 2026).
Original GitHub issue: https://github.com/actualbudget/actual/issues/8178

Issue Type

Documentation Bug/Error

Description

The docs website build is currently broken on master, which makes the netlify/actualbudget-website/deploy-preview check fail on all open pull requests (e.g. #8172, #8174, #8175, #8176, #8177).

PR #8155 renamed packages/docs/docs/migration/nynab.md to nynab.mdx, but one cross-reference was not updated: packages/docs/docs/api/index.md (line 89) still links to ../migration/nynab.md. Docusaurus is configured to throw on broken links, so the whole site build aborts:

Error: Docusaurus found broken links!

Exhaustive list of all broken links found:
- Broken link on source page path = /docs/api/:
   -> linking to ../migration/nynab.md (resolved as: /docs/migration/nynab.md)

How to reproduce:

  1. Check out master
  2. Run yarn workspace docs build
  3. The build fails with the error above

Verified fix: updating the link in packages/docs/docs/api/index.md from ../migration/nynab.md to ../migration/nynab.mdx makes yarn workspace docs build succeed again (verified locally).

Documentation URL

https://github.com/actualbudget/actual/blob/master/packages/docs/docs/api/index.md

Documentation Category

Development

Expected/Desired Content

The "importing nYNAB data" link on the API overview page should point to the renamed file (../migration/nynab.mdx) so the docs site builds again and deploy previews go green on open PRs.

Originally created by @augustocbx on GitHub (Jun 10, 2026). Original GitHub issue: https://github.com/actualbudget/actual/issues/8178 ### Issue Type Documentation Bug/Error ### Description The docs website build is currently broken on `master`, which makes the `netlify/actualbudget-website/deploy-preview` check fail on all open pull requests (e.g. #8172, #8174, #8175, #8176, #8177). PR #8155 renamed `packages/docs/docs/migration/nynab.md` to `nynab.mdx`, but one cross-reference was not updated: `packages/docs/docs/api/index.md` (line 89) still links to `../migration/nynab.md`. Docusaurus is configured to throw on broken links, so the whole site build aborts: ``` Error: Docusaurus found broken links! Exhaustive list of all broken links found: - Broken link on source page path = /docs/api/: -> linking to ../migration/nynab.md (resolved as: /docs/migration/nynab.md) ``` **How to reproduce:** 1. Check out `master` 2. Run `yarn workspace docs build` 3. The build fails with the error above **Verified fix:** updating the link in `packages/docs/docs/api/index.md` from `../migration/nynab.md` to `../migration/nynab.mdx` makes `yarn workspace docs build` succeed again (verified locally). ### Documentation URL https://github.com/actualbudget/actual/blob/master/packages/docs/docs/api/index.md ### Documentation Category Development ### Expected/Desired Content The "importing nYNAB data" link on the API overview page should point to the renamed file (`../migration/nynab.mdx`) so the docs site builds again and deploy previews go green on open PRs.
GiteaMirror commented 2026-06-11 13:08:20 -05:00
Author
Owner
Copy Link
Copy Source

@matt-fidd commented on GitHub (Jun 10, 2026):

Fixed in https://github.com/actualbudget/actual/pull/8173

<!-- gh-comment-id:4670110569 --> @matt-fidd commented on GitHub (Jun 10, 2026): Fixed in https://github.com/actualbudget/actual/pull/8173
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
AI generated
API
bank sync
budgeting
bug
can’t replicate
dependencies
docker
documentation
electron
experimental feature
feature
feedback
goal templates
good first issue
help wanted
importers
maintenance
needs info
needs testing
needs triage
needs votes
openid
payees
pull-request
Mirrored from GitHub Pull Request
 regression
reports
responsive
rules
schedules
server
✨ merged
split transactions
tech debt
tech-support
theme
transaction import
transaction reconciliation
transactions
translations
upstream
user interface
✅ approved
wontfix
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
GiteaMirror ninjasurge (Kaehlen Rog)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/actual#117687