docs: prune and restructure the guides section - #3483
Draft
Lotte-Verheyden wants to merge 2 commits into
Draft
Conversation
Remove outdated cookbooks and videos, consolidate integration cookbooks into their /integrations reference pages, move benchmarks and the 2023 webinar to /resources/engineering, and sort the remaining guides by topic instead of format. Every removed URL redirects to the closest living equivalent.
|
Check out this pull request on See visual diffs & provide feedback on Jupyter Notebooks. Powered by ReviewNB |
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Move the Ragas evaluation cookbook to /resources/engineering (redirect and inbound links retargeted) and keep the video gallery on the /guides page instead of folding videos into the topic categories.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Restructures the guides section following the docs cleanup decisions from the 2026-08-05 marketing sync: remove outdated content, keep integration material in
/integrations(one page per integration, no parallel cookbook entries), move benchmarks, webinars, and evaluation-library write-ups to/resources/engineering, and sort the remaining cookbooks by topic. Review feedback from the first pass is incorporated (Ragas cookbook moved to resources; the video gallery stays on/guides).Net result:
/guidesgoes from 50 cookbooks + 13 videos in 8 fuzzy categories to 18 cookbooks in exactly three topic categories (Evaluation, Examples, Prompt Management) plus a gallery of the 4 current videos. The integrations catalog gains 5 real pages, engineering resources gains 4. Every removed URL redirects to the closest living equivalent, all internal links are retargeted, and all pages and redirects were verified against a local dev server.Removed from the site (outdated or redundant)
guides/cookbook/integration_langserve+integrations/frameworks/langserveguides/cookbook/integration_llama-index-callbackguides/cookbook/integration_llama-index_instrumentationguides/cookbook/integration_llama-index_milvus-lite/integrations/other/milvusguides/cookbook/integration_llama_index_posthog_mistralguides/cookbook/evaluation_with_uptrainguides/cookbook/evaluation_with_langchainguides/cookbook/example_decorator_openai_langchainguides/cookbook/integration_langchain+js_integration_langchainguides/cookbook/integration_openai_sdkguides/cookbook/integration_openai_structured_output#structured-outputguides/cookbook/integration_azure_openai_langchainguides/videos/introducing-langfuse-2.0,introducing-datasets-v2,introducing-python-decorator,posthog-integration,llm-playground,llm-as-a-judge-eval-on-dataset-experimentsguides/videos/run-langfuse-locally,external-evaluation-pipelinesMerged into the integration reference page, then removed
integration_litellm_proxy+js_integration_litellm_proxyintegration_databricksjs_integration_openaiMoved to a better home (content unchanged, URL redirects)
otel_integration_openllmetry,otel_integration_openlit,otel_integration_mlflow,otel_integration_arize/integrations/other/(OpenLLMetry, OpenLIT, MLflow, OpenInference)integration_langgraph/integrations/frameworks/langgraphevaluation_of_rag_with_ragas/resources/engineering/evaluation-of-rag-with-ragaslangfuse_sdk_performance_test,prompt_management_performance_benchmark/resources/engineering/guides/videos/webinar-observability-llm-systems/resources/engineering/No longer dual-published on /guides
These lived at two URLs with identical content; they now exist only as their
/integrationspage (old URL redirects): LlamaIndex, LlamaIndex Workflows, Amazon Bedrock, Anthropic (Python), Anthropic (JS), and OpenAI Assistants API. The Assistants page additionally gets a deprecation note (OpenAI shuts the API down on August 26, 2026) pointing to the Responses API migration guide.Kept on /guides, edited in place
guides/index.mdxexample_evaluating_openai_agents,example_langgraph_agentsexample_data_migration+example_data_migration-jpexample_intent_classification_pipeline,example_llm_security_monitoring,js_prompt_management_langchainLink fixes and plumbing
lib/redirects.js: 41 new redirects, 20 existing entries retargeted so nothing points at a deleted page.cookbook/_routes.jsonreduced to 84 entries; five navmeta.jsonfiles updated.Open follow-ups (deliberately not in this PR):
guides/cookbook/prompt_management_openai_functionsstill uses the legacy OpenAI functions API; refresh to tool calling or delete.example_multi_modal_traces) will come as a separate PR.