Skip to content

Get Started guide and v2.0 blog post link to pages the site does not build #1781

Open

Description

@joshunrau

Three links in the user docs and blog lead to 404s because their targets are not in the build. The "How to Get Started with ODC" guide sends readers to "How to Export Data" and "How to Visualize Data" for more detail. Both pages are draft: true, which Starlight leaves out of production builds. The v2.0 announcement post links its "v2.0.0 migration guide" to /docs/updating/v2.0.0. That page was folded into the changelog by b7073d2dc, and the path never had the /en/ prefix every docs URL carries anyway. All three return 404 on https://opendatacapture.org. These are the guide's only pointers for exporting and graphing data, and the post's only pointer for operators upgrading to v2.

Where

docs/en/3-guides/3.4-how-to-get-started-with-odc.mdx:125-128:

For more detail, see:

- [How to Export Data](/en/docs/guides/how-to-export-data/)
- [How to Visualize Data](/en/docs/guides/how-to-visualize-data/)

docs/en/3-guides/3.1-how-to-export-data.mdx:6 and docs/en/3-guides/3.2-how-to-visualize-data.mdx:6:

draft: true

blog/open-data-capture-v2.md:61:

If you're running Open Data Capture, see the [v2.0.0 migration guide](https://opendatacapture.org/docs/updating/v2.0.0) for the exact upgrade steps, ...

The upgrade steps now live under the 2.0.0 heading of docs/en/6-changelog/changelog.md, rendered at /en/docs/changelog/#200.

Reproduce

  1. Open https://opendatacapture.org/en/docs/guides/how-to-get-started-with-odc/ and click "How to Export Data" or "How to Visualize Data" under "Review and Export Data".
  2. Open https://opendatacapture.org/en/blog/open-data-capture-v2/ and click "v2.0.0 migration guide".

Actual: all three land on the 404 page.
Expected: each link reaches a published page: the upgrade steps in the changelog for the blog post, and either published guides or no link at all for the get-started guide.

Tests

Neither docs/ nor blog/ has a test runner (docs/AGENTS.md), so the build is the check. After pnpm --filter @opendatacapture/outreach build, every internal href in dist/en/docs/guides/how-to-get-started-with-odc/index.html and dist/en/blog/open-data-capture-v2/index.html should resolve to a file under dist/.

Suggested fix

Point the blog link at /en/docs/changelog/#200. In the get-started guide, drop the two links until the export and visualize guides are finished. Both drafts stop after "Select Your Group", so they are not ready to be published as they are.

Activity

  1. added
    BugType: existing behavior is wrong
    Difficulty: LowIsolated change, about 2 hours or less
    Area: Outreachapps/outreach and docs/ (marketing site and user documentation)
    Good First IssueWell-scoped, low-risk and self-contained; a good entry point for a new contributor
    on Oct 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Area: Outreachapps/outreach and docs/ (marketing site and user documentation)BugType: existing behavior is wrongDifficulty: LowIsolated change, about 2 hours or lessGood First IssueWell-scoped, low-risk and self-contained; a good entry point for a new contributorPriority: MediumReal value; schedule normally

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions