10/27 work (#1146)

* add info about snippet link resolution
* add `langchain_milvus` to refs
* correct browser titles for package ref pages
* langsmith ref homepage
* don't warn on absolute link usage in refs
* fix broken links
* add note about completions API compat for OpenAI
* add OpenRouter callout
* formatting
* move langgraph errors to folder (and add redirects)
* remove deprecated gemini image gen model
* grok/groq confusion callout

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: mdrxy

.github/copilot-instructions.md

@@ -59,6 +59,12 @@ If any code fences like this exist on the code page, then two outputs (one for e
 
 For implementation details, see `pipeline/preprocessors/markdown_preprocessor.py`.
 
+## Snippets
+
+Snippet files in `src/snippets/` are reusable MDX content that can be imported into multiple pages. These snippets undergo special link preprocessing during the build process that converts absolute `/oss/` links to relative paths.
+
+**Important:** When writing links in snippets, be careful about path segments. Read the docstrings and comments in `pipeline/core/builder.py` method `_process_snippet_markdown_file` (lines 807-872) to understand how snippet link preprocessing works and why certain path structures are required.
+
 ## Style guide
 
 In general, follow the [Google Developer Documentation Style Guide](https://developers.google.com/style). You can also access this style guide through the [Vale-compatible implementation](https://github.com/errata-ai/Google).

AGENTS.md

@@ -59,6 +59,12 @@ If any code fences like this exist on the code page, then two outputs (one for e
 
 For implementation details, see `pipeline/preprocessors/markdown_preprocessor.py`.
 
+## Snippets
+
+Snippet files in `src/snippets/` are reusable MDX content that can be imported into multiple pages. These snippets undergo special link preprocessing during the build process that converts absolute `/oss/` links to relative paths.
+
+**Important:** When writing links in snippets, be careful about path segments. Read the docstrings and comments in `pipeline/core/builder.py` method `_process_snippet_markdown_file` (lines 807-872) to understand how snippet link preprocessing works and why certain path structures are required.
+
 ## Style guide
 
 In general, follow the [Google Developer Documentation Style Guide](https://developers.google.com/style). You can also access this style guide through the [Vale-compatible implementation](https://github.com/errata-ai/Google).

CLAUDE.md

@@ -59,6 +59,12 @@ If any code fences like this exist on the code page, then two outputs (one for e
 
 For implementation details, see `pipeline/preprocessors/markdown_preprocessor.py`.
 
+## Snippets
+
+Snippet files in `src/snippets/` are reusable MDX content that can be imported into multiple pages. These snippets undergo special link preprocessing during the build process that converts absolute `/oss/` links to relative paths.
+
+**Important:** When writing links in snippets, be careful about path segments. Read the docstrings and comments in `pipeline/core/builder.py` method `_process_snippet_markdown_file` (lines 807-872) to understand how snippet link preprocessing works and why certain path structures are required.
+
 ## Style guide
 
 In general, follow the [Google Developer Documentation Style Guide](https://developers.google.com/style). You can also access this style guide through the [Vale-compatible implementation](https://github.com/errata-ai/Google).

README.md

@@ -9,9 +9,8 @@
 
 > [!IMPORTANT]
 >
-> * The LangSmith API and [SDK](https://github.com/langchain-ai/langsmith-sdk) references are not yet consolidated to this repo. Visit their documentation:
+> * The LangSmith API and [SDK](https://github.com/langchain-ai/langsmith-sdk) references are not yet fully consolidated to this repo. Visit their documentation:
 >   * [`HTTP API Reference`](https://api.smith.langchain.com/redoc)
->   * [`Python SDK reference`](https://docs.smith.langchain.com/reference/python/reference)
 >   * [`JavaScript/TypeScript SDK reference`](https://docs.smith.langchain.com/reference/js)
 
 ---
@@ -156,6 +155,7 @@ These can be used directly using the `Makefile` or via the `docs` CLI tool:
 ### File formats
 
 * **Markdown files** (`.md`, `.mdx`) - Standard documentation content
+* **Snippets** (`src/snippets/`) - Reusable MDX content that can be imported into multiple pages. **Important:** Snippets undergo special link preprocessing. When writing links in snippets, be careful about path segments.
 * **Jupyter notebooks** (`.ipynb`) - Converted to markdown during build, though **these are not recommended for new content!** Your PR will likely be rejected if you attempt to add a Jupyter notebook unless asked to by a maintainer.
 * **Assets** - Images and other files are copied to the build directory
 

pipeline/core/builder.py

@@ -826,7 +826,12 @@ def _process_snippet_markdown_file(
 
             # Convert /oss/ links to relative paths that work from any language context
             def convert_oss_link(match: re.Match) -> str:
-                """Convert /oss/ links to language-agnostic relative paths."""
+                """Convert /oss/ links to language-agnostic relative paths.
+
+                IMPORTANT: the conversion creates relative paths that resolve from the
+                parent page's directory.
+                - /oss/providers/groq → ../providers/groq
+                """
                 pre = match.group(1)  # Everything before the URL
                 url = match.group(2)  # The URL
                 post = match.group(3)  # Everything after the URL

pipeline/preprocessors/link_map.py

@@ -250,7 +250,7 @@ class LinkMap(TypedDict):
         "host": "https://reference.langchain.com/javascript/",
         "scope": "js",
         "links": {
-            "Runtime": "interfaces/_langchain_langgraph.index.Runtime.html",
+            "Runtime": "modules/langgraph.index.Runtime.html",
             "tool": "functions/_langchain_core.tools.tool.html",
             "ToolNode": "classes/langchain.index.ToolNode.html",
             "UsageMetadata": "types/_langchain_core.messages.UsageMetadata.html",

pipeline/tools/partner_pkg_table.py

@@ -161,7 +161,7 @@ def package_row(p: dict) -> str:
         f"| {provider} "
         f"| [`{p['name']}`]({p['package_url']}) "
         f'| <a href="https://pypi.org/project/{p["name"]}/" target="_blank"><img src="https://static.pepy.tech/badge/{p["name"]}/month" alt="Downloads per month" noZoom class="rounded not-prose" /></a> '  # noqa: E501
-        f'| <a href="https://pypi.org/project/{p["name"]}/" target="_blank"><img src="https://img.shields.io/pypi/v/{p["name"]}?style=flat-square&label=%20&color=orange" alt="PyPI - Latest version" noZoom class="rounded not-prose" /></a> '  # noqa: E501
+        f'| <a href="https://pypi.org/project/{p["name"]}/" target="_blank"><img src="https://img.shields.io/pypi/v/{p["name"]}?style=flat-square&label=%20" alt="PyPI - Latest version" noZoom class="rounded not-prose" /></a> '  # noqa: E501
         f"| {js} |"
     )
 

reference/python/docs/integrations/langchain_milvus.md

@@ -8,6 +8,4 @@ title: Milvus
 [![PyPI - License](https://img.shields.io/pypi/l/langchain-milvus)](https://opensource.org/licenses/MIT)
 [![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-milvus)](https://pypistats.org/packages/langchain-milvus)
 
-!!! note
-    This package ref has not yet been fully migrated to v1.
-
+::: langchain_milvus

reference/python/docs/langchain/langchain/index.md

@@ -1,3 +1,7 @@
+---
+title: LangChain home
+---
+
 # :simple-langchain:{ .lg .middle } `langchain`
 
 [![PyPI - Version](https://img.shields.io/pypi/v/langchain?label=%20)](https://pypi.org/project/langchain/#history)

reference/python/docs/langchain_classic/index.md

@@ -1,3 +1,7 @@
+---
+title: LangChain Classic home
+---
+
 # :fontawesome-solid-building-columns:{ .lg .middle } `langchain-classic`
 
 [![PyPI - Version](https://img.shields.io/pypi/v/langchain-classic?label=%20)](https://pypi.org/project/langchain-classic/#history)