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

Aperta Adatta ai principianti
  • Qualcosa non va?
#1,781 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@Sanilas-ai ci sta già lavorando.

Dal 30/10/2026.

  • #1843 di @Sanilas-ai — aperta

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
85/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
typescript
Ambito
documentation

Direzione di ricerca

Leggi i link in docs/en/3-guides/3.4-how-to-get-started-with-odc.mdx e blog/open-data-capture-v2.md, insieme allo stato di bozza delle due guide sull’esportazione e sulla visualizzazione. Fai puntare il link del blog a /en/docs/changelog/#200 e rimuovi i link alle guide finché le bozze non sono pronte. Esegui pnpm --filter @opendatacapture/outreach build e verifica che i link interni nelle due pagine di output specificate si risolvano in dist/.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Area: Outreach Bug Difficulty: Low Good First Issue Priority: Medium

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.

Lingua principale
TypeScript
Stelle
119
Fork
19
Merge medio
4g 11h
PR unite (30g)
35

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di DouglasNeuroInformatics/OpenDataCapture

Tutte le issue di DouglasNeuroInformatics/OpenDataCapture

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.