From 5298441ac98e70844401f5da9201a6d727df7d3b Mon Sep 17 00:00:00 2001 From: Lotte Verheyden <48100308+Lotte-Verheyden@users.noreply.github.com> Date: Fri, 7 Aug 2026 14:36:20 -0700 Subject: [PATCH 1/2] docs: prune and restructure the guides section 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. --- components/CookbookIndex.tsx | 26 +- content/blog/2024-04-python-decorator.mdx | 9 +- content/blog/2024-08-what-is-langchain.mdx | 2 +- ...10-opentelemetry-for-llm-observability.mdx | 4 +- content/blog/launch-week-1.mdx | 4 +- .../2024-02-27-llama-index-integration.mdx | 2 +- .../2024-03-05-uptrain-integration.mdx | 4 +- .../2024-04-21-openai-integration-JS-SDK.mdx | 2 +- content/changelog/2024-04-24-decorator.mdx | 7 +- .../2024-08-08-openai-structured-outputs.mdx | 2 +- .../2024-08-21-openai-multi-modal-traces.mdx | 4 +- .../observability/features/agent-graphs.mdx | 2 +- content/docs/observability/get-started.mdx | 12 - .../prompt-management/features/caching.mdx | 2 +- .../prompt-management/features/config.mdx | 2 +- .../fifteen-questions-langfuse-answered.mdx | 2 +- .../cookbook/evaluation_with_langchain.md | 217 ------ .../cookbook/evaluation_with_uptrain.md | 411 ----------- .../cookbook/example_data_migration-jp.mdx | 3 + .../cookbook/example_data_migration.mdx | 3 + .../example_decorator_openai_langchain.md | 148 ---- .../example_evaluating_openai_agents.md | 2 +- .../example_intent_classification_pipeline.md | 2 +- .../cookbook/example_langgraph_agents.mdx | 2 +- .../example_llm_security_monitoring.md | 2 +- .../cookbook/integration_amazon_bedrock.md | 241 ------- .../guides/cookbook/integration_anthropic.mdx | 156 ---- .../integration_azure_openai_langchain.md | 220 ------ .../cookbook/integration_databricks.mdx | 250 ------- .../guides/cookbook/integration_langchain.md | 200 ----- .../guides/cookbook/integration_langserve.md | 187 ----- .../cookbook/integration_litellm_proxy.mdx | 209 ------ .../integration_llama-index-callback.md | 117 --- ...integration_llama-index_instrumentation.md | 126 ---- .../integration_llama-index_milvus-lite.mdx | 126 ---- .../cookbook/integration_llama_index.mdx | 110 --- ...integration_llama_index_posthog_mistral.md | 248 ------- .../integration_llamaindex_workflows.mdx | 135 ---- .../cookbook/integration_openai_assistants.md | 190 ----- .../cookbook/integration_openai_sdk.mdx | 405 ----------- .../integration_openai_structured_output.md | 247 ------- .../cookbook/js_integration_anthropic.mdx | 109 --- .../cookbook/js_integration_langchain.mdx | 125 ---- .../cookbook/js_integration_litellm_proxy.mdx | 169 ----- .../guides/cookbook/js_integration_openai.mdx | 287 -------- .../js_prompt_management_langchain.mdx | 2 +- content/guides/cookbook/meta.json | 32 +- content/guides/index.mdx | 14 +- .../beginners-guide-to-rag-evaluation.mdx | 1 + .../videos/debug-rag-agent-with-tracing.mdx | 1 + .../videos/external-evaluation-pipelines.mdx | 30 - content/guides/videos/headless-langfuse.mdx | 1 + .../guides/videos/introducing-datasets-v2.mdx | 33 - .../videos/introducing-langfuse-2.0.mdx | 16 - .../videos/introducing-python-decorator.mdx | 36 - ...as-a-judge-eval-on-dataset-experiments.mdx | 35 - content/guides/videos/llm-playground.mdx | 15 - content/guides/videos/meta.json | 11 +- content/guides/videos/posthog-integration.mdx | 15 - .../videos/replace-vibes-with-evals.mdx | 1 + .../guides/videos/run-langfuse-locally.mdx | 22 - content/handbook/chapters/why.mdx | 2 +- content/integrations/frameworks/langchain.mdx | 16 +- .../frameworks/langgraph.mdx} | 63 +- content/integrations/frameworks/langserve.md | 180 ----- content/integrations/frameworks/meta.json | 2 +- content/integrations/gateways/litellm.mdx | 142 +++- .../model-providers/amazon-bedrock.md | 1 + .../model-providers/databricks.mdx | 137 +++- .../model-providers/openai-assistants-api.md | 3 +- .../model-providers/openai-js.mdx | 74 +- .../model-providers/openai-py.mdx | 16 +- .../integrations/model-providers/xai-grok.mdx | 2 +- content/integrations/other/meta.json | 4 + .../other/mlflow.md} | 38 +- .../other/openinference.md} | 37 +- .../other/openlit.md} | 11 +- .../other/openllmetry.md} | 18 +- content/library/index.mdx | 2 +- content/marketing/enterprise.mdx | 2 +- .../langfuse-sdk-performance-test.md} | 59 +- content/resources/engineering/meta.json | 5 +- ...rompt-management-performance-benchmark.md} | 7 - .../webinar-observability-llm-systems.mdx | 0 cookbook/_routes.json | 125 +--- cookbook/evaluation_with_langchain.ipynb | 376 ---------- cookbook/evaluation_with_uptrain.ipynb | 674 ----------------- cookbook/example_data_migration-jp.ipynb | 4 +- cookbook/example_data_migration.ipynb | 4 +- .../example_decorator_openai_langchain.ipynb | 255 ------- .../example_evaluating_openai_agents.ipynb | 2 +- ...ample_intent_classification_pipeline.ipynb | 4 +- cookbook/example_langgraph_agents.ipynb | 2 +- .../example_llm_security_monitoring.ipynb | 2 +- cookbook/integration_amazon_bedrock.ipynb | 1 + .../integration_azure_openai_langchain.ipynb | 243 ------- cookbook/integration_databricks.ipynb | 358 --------- cookbook/integration_langchain.ipynb | 387 ---------- cookbook/integration_langgraph.ipynb | 2 +- cookbook/integration_langserve.ipynb | 246 ------- cookbook/integration_litellm_proxy.ipynb | 308 -------- .../integration_llama-index-callback.ipynb | 229 ------ ...egration_llama-index_instrumentation.ipynb | 273 ------- .../integration_llama-index_milvus-lite.ipynb | 233 ------ ...egration_llama_index_posthog_mistral.ipynb | 423 ----------- cookbook/integration_openai_assistants.ipynb | 22 +- cookbook/integration_openai_sdk.ipynb | 682 ------------------ ...integration_openai_structured_output.ipynb | 392 ---------- cookbook/js_integration_langchain.ipynb | 202 ------ cookbook/js_integration_litellm_proxy.ipynb | 246 ------- cookbook/js_integration_openai.ipynb | 378 ---------- cookbook/js_prompt_management_langchain.ipynb | 2 +- cookbook/langfuse_sdk_performance_test.ipynb | 2 +- cookbook/otel_integration_arize.ipynb | 2 + cookbook/otel_integration_mlflow.ipynb | 2 + cookbook/otel_integration_openlit.ipynb | 2 + cookbook/otel_integration_openllmetry.ipynb | 3 + ...mpt_management_performance_benchmark.ipynb | 1 - lib/redirects.js | 205 +++++- 119 files changed, 714 insertions(+), 11397 deletions(-) delete mode 100644 content/guides/cookbook/evaluation_with_langchain.md delete mode 100644 content/guides/cookbook/evaluation_with_uptrain.md delete mode 100644 content/guides/cookbook/example_decorator_openai_langchain.md delete mode 100644 content/guides/cookbook/integration_amazon_bedrock.md delete mode 100644 content/guides/cookbook/integration_anthropic.mdx delete mode 100644 content/guides/cookbook/integration_azure_openai_langchain.md delete mode 100644 content/guides/cookbook/integration_databricks.mdx delete mode 100644 content/guides/cookbook/integration_langchain.md delete mode 100644 content/guides/cookbook/integration_langserve.md delete mode 100644 content/guides/cookbook/integration_litellm_proxy.mdx delete mode 100644 content/guides/cookbook/integration_llama-index-callback.md delete mode 100644 content/guides/cookbook/integration_llama-index_instrumentation.md delete mode 100644 content/guides/cookbook/integration_llama-index_milvus-lite.mdx delete mode 100644 content/guides/cookbook/integration_llama_index.mdx delete mode 100644 content/guides/cookbook/integration_llama_index_posthog_mistral.md delete mode 100644 content/guides/cookbook/integration_llamaindex_workflows.mdx delete mode 100644 content/guides/cookbook/integration_openai_assistants.md delete mode 100644 content/guides/cookbook/integration_openai_sdk.mdx delete mode 100644 content/guides/cookbook/integration_openai_structured_output.md delete mode 100644 content/guides/cookbook/js_integration_anthropic.mdx delete mode 100644 content/guides/cookbook/js_integration_langchain.mdx delete mode 100644 content/guides/cookbook/js_integration_litellm_proxy.mdx delete mode 100644 content/guides/cookbook/js_integration_openai.mdx delete mode 100644 content/guides/videos/external-evaluation-pipelines.mdx delete mode 100644 content/guides/videos/introducing-datasets-v2.mdx delete mode 100644 content/guides/videos/introducing-langfuse-2.0.mdx delete mode 100644 content/guides/videos/introducing-python-decorator.mdx delete mode 100644 content/guides/videos/llm-as-a-judge-eval-on-dataset-experiments.mdx delete mode 100644 content/guides/videos/llm-playground.mdx delete mode 100644 content/guides/videos/posthog-integration.mdx delete mode 100644 content/guides/videos/run-langfuse-locally.mdx rename content/{guides/cookbook/integration_langgraph.mdx => integrations/frameworks/langgraph.mdx} (95%) delete mode 100644 content/integrations/frameworks/langserve.md rename content/{guides/cookbook/otel_integration_mlflow.md => integrations/other/mlflow.md} (98%) rename content/{guides/cookbook/otel_integration_arize.md => integrations/other/openinference.md} (98%) rename content/{guides/cookbook/otel_integration_openlit.md => integrations/other/openlit.md} (98%) rename content/{guides/cookbook/otel_integration_openllmetry.md => integrations/other/openllmetry.md} (98%) rename content/{guides/cookbook/langfuse_sdk_performance_test.md => resources/engineering/langfuse-sdk-performance-test.md} (98%) rename content/{guides/cookbook/prompt_management_performance_benchmark.md => resources/engineering/prompt-management-performance-benchmark.md} (98%) rename content/{guides/videos => resources/engineering}/webinar-observability-llm-systems.mdx (100%) delete mode 100644 cookbook/evaluation_with_langchain.ipynb delete mode 100644 cookbook/evaluation_with_uptrain.ipynb delete mode 100644 cookbook/example_decorator_openai_langchain.ipynb delete mode 100644 cookbook/integration_azure_openai_langchain.ipynb delete mode 100644 cookbook/integration_databricks.ipynb delete mode 100644 cookbook/integration_langchain.ipynb delete mode 100644 cookbook/integration_langserve.ipynb delete mode 100644 cookbook/integration_litellm_proxy.ipynb delete mode 100644 cookbook/integration_llama-index-callback.ipynb delete mode 100644 cookbook/integration_llama-index_instrumentation.ipynb delete mode 100644 cookbook/integration_llama-index_milvus-lite.ipynb delete mode 100644 cookbook/integration_llama_index_posthog_mistral.ipynb delete mode 100644 cookbook/integration_openai_sdk.ipynb delete mode 100644 cookbook/integration_openai_structured_output.ipynb delete mode 100644 cookbook/js_integration_langchain.ipynb delete mode 100644 cookbook/js_integration_litellm_proxy.ipynb delete mode 100644 cookbook/js_integration_openai.ipynb diff --git a/components/CookbookIndex.tsx b/components/CookbookIndex.tsx index 010daf5869..0a4febc7cf 100644 --- a/components/CookbookIndex.tsx +++ b/components/CookbookIndex.tsx @@ -1,15 +1,27 @@ import { guidesSource } from "@/lib/source"; -import { FileCode, ArrowRight } from "lucide-react"; +import { FileCode, Video, ArrowRight } from "lucide-react"; import { Cards, Card } from "@/components/docs"; type CookbookPage = ReturnType[number]; -export const CookbookIndex = ({ categories }: { categories?: string[] }) => ( +export const CookbookIndex = ({ + categories, + includeVideos, +}: { + categories?: string[]; + includeVideos?: boolean; +}) => ( <> {Object.entries( guidesSource .getPages() - .filter((page) => page.url.startsWith("/guides/cookbook/")) + .filter( + (page) => + page.url.startsWith("/guides/cookbook/") || + (includeVideos && + page.url.startsWith("/guides/videos/") && + !!page.data.category), + ) .reduce( (acc, page) => { const category = @@ -52,7 +64,13 @@ export const CookbookIndex = ({ categories }: { categories?: string[] }) => ( href={page.url} key={page.url} className="no-underline group" - icon={} + icon={ + page.url.startsWith("/guides/videos/") ? ( +