-
[NA] [DOCS] Promote MCP server & refresh docs-v2 (#6938)
frostbyte_neo 发布于
2026-06-01 11:15:15 +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
- [NA] [DOCS] Update v2 docs screenshots with fresh UI captures
Updated 18 screenshots across all major v2 docs sections:
- Observability: traces overview, trace detail page, traces quickstart
- Prompt library: library list, text/chat create modals, version history
- Prompt playground: two-variant comparison view
- Evaluation: test suite UI with assertions, experiments comparison
- Development: agent configuration and sandbox pages
- Ollie: hero page, trace analysis, fix recommendations, test suite request
Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com
- [NA] [DOCS] Promote MCP server to Getting Started, Integrations, and homepage
- Add MCP Server as a first-class entry in Getting Started (after Quickstart)
- Add AI Coding Assistants section at the top of the Integrations tab
- Remove MCP server from Prompt Library (wrong conceptual home)
- Add MCP tip callout on homepage "How to use Opik" section
- Add MCP Server card to "Explore by feature" grid on homepage
- Add AI Coding Assistants section to integrations overview page
- Update redirects for old prompt-library/mcp-server URL
Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com
- [NA] [DOCS] Update v2 docs: home page revamp, screenshots, and changelog updates
- Rewrite home.mdx with new headline, intro paragraph, and visual diagram
- Update quickstart and evaluate_your_llm pages with refreshed screenshots
- Update ADK integration page with fresh UI captures
- Add new changelog entries through 2026
- Remove v1_noindex.js (canonical URL approach supersedes it)
Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com
- Revert "[NA] [DOCS] Update v2 docs screenshots with fresh UI captures"
This reverts commit
4b89121443.- [NA] [DOCS] Remove canonical-url from opik-university pages
These pages have no equivalent in the latest docs, so pointing a canonical
URL at the v2 root was incorrect.Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com
- [NA] [DOCS] Remove canonical-url from cookbook and roadmap pages
These v1 pages have no equivalent in the latest docs, so canonicalizing
them to the v2 root was incorrect. Kept home.mdx, which maps to the v2 home.Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com
- [NA] [DOCS] Fix broken canonical-url on changelog pages
The per-date canonical-urls (changelog/YYYY-MM-DD) 404'd — that URL format
doesn't exist. The changelog is a single feed; individual dated URLs redirect
to the index. Point every entry's canonical at the changelog index, which
resolves 200.Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com
Co-authored-by: Claude Sonnet 4.6 noreply@anthropic.com
下载附件