-
[NA] [DOCS] Improve docs-v2 home page and quickstart content (#6909)
frostbyte_neo 发布于
2026-05-29 14:50:23 +00:00 - [NA] [DOCS] Improve docs-v2 home page and quickstart content
- Rewrite home page: remove v1 migration note, replace 6 generic cards
with 4 intent-based scenario cards, remove enterprise paragraph and
architecture diagram, fix stale /v1/prompt_engineering/playground link - Fix quickstart: remove two TODO comments, fix truncated Next Steps sentence
- Fix optimization quickstart: remove "In Opik 2.0" callout note
- Rewrite tracing/concepts: scope page to Traces/Spans/Threads only;
remove off-topic Metrics/Optimization/Evaluation sections; fix broken
/v1/evaluation link and duplicate Log traces/Log agents links - Fix docs.yml redirect: /agent_optimization/opik_optimizer/quickstart
now points to the quickstart page instead of the overview
Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com
- [NA] [DOCS] Restore enterprise section; remove all v1 doc links from latest
- Restore "Open-source access meets enterprise performance" section on
home page (trimmed to one paragraph; removes comparison puffery) - Remove all /v1/ doc page links from docs-v2 pages (12 instances across
10 files): annotate_traces, cost_tracking, log_traces,
production_monitoring, optimize_multimodal, parameter_optimizer,
adk integration, evaluate_agents, structure_output_compliance,
evaluate_your_llm (×2), log_experiments_with_rest_api - Two /v1/prompt_engineering links updated to /prompt-library/getting-started
rather than removed (content was substantive, not just a cross-ref)
Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com
- [NA] [DOCS] Inject noindex for v1 pages to prevent duplicate content
Add v1_noindex.js: injects
on all /v1/ documentation pages. Keeps v1 accessible via the version
switcher but prevents it from competing with latest docs in search results.Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com
- [NA] [DOCS] Switch v1 SEO from noindex to canonical links
Replace noindex injection with canonical link injection. For each v1
page, injects pointing to the latest equivalent:- Strips /v1/ prefix for unchanged sections (tracing, evaluation,
self-host, integrations, reference) - Maps renamed sections:
agent_optimization/* → /development/optimization-runs/overview
prompt_engineering/* → /prompt-library/getting-started
opik-university/* → /
Canonical consolidates link equity onto latest pages rather than
discarding it, which is the correct approach when v1 pages may have
accumulated external backlinks.Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com
- [NA] [DOCS] Add canonical-url frontmatter to all 314 v1 pages; remove JS injection
Each v1 page now declares its canonical latest-equivalent URL directly
in frontmatter so Fern renders a proper tag.
Replaces the v1_noindex.js client-side injection approach.Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com
Co-authored-by: Claude Sonnet 4.6 noreply@anthropic.com
下载附件