发布

  • [OPIK-6202] [FE] [DOCS] fix: explainer docs anchors and wrapper re-exports (#6472)

    frostbyte_neo 发布于 2026-04-24 07:30:24 +00:00

    Follow-up to OPIK-5856 (#6456) addressing 8 hash-anchor mismatches
    the reviewer flagged. Base pages resolved (HTTP 200) but fragments
    pointed to sections that had been renamed or removed.

    v2/constants/explainers.ts:

    • #running-an-evaluation → #the-evaluation-loop (two call sites)
    • /evaluation/concepts#experiment-configuration →
      /evaluation/overview#two-approaches-to-evaluation
    • /evaluation/concepts#experiments and #test-suites →
      #test-suites-assertion-based-testing

    v1/constants/explainers.ts:

    • /evaluation/concepts#test-suites → #experiments (v1 still uses
      "experiments" terminology in concepts.mdx)
    • /prompt_engineering/improve: #generate → #prompt-generator,
      #improve → #prompt-improver

    Also renamed EXPLAINER_ID.whats_an_test_suite → whats_a_test_suite
    (grammar fix carried across base + v1 + v2 explainer maps).

    Dropped export * from "@/lib/utils" from src/v1/lib/utils.ts and
    src/v2/lib/utils.ts. All 56 importers of the wrappers only take
    buildDocsUrl / buildDocsMarkdownUrl; the wildcard re-export was
    unused and inconsistent with the rest of the repo.

    Piggybacked a small docs link fix in Fern MDX (unrelated to the FE
    changes but surfaced during review): the "Feedback definitions"
    link in evaluation/annotation_queues.mdx and
    evaluation/advanced/annotation_queues.mdx used a relative path that
    Fern resolved into a doubled configuration/configuration/ segment,
    404ing on the preview. Switched both to absolute canonical paths.

    下载附件