[PR #1382] [MERGED] refactor: new middleware docs #1516

Closed
opened 2026-02-17 17:22:26 -05:00 by yindo · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/docs/pull/1382
Author: @sydney-runkle
Created: 11/12/2025
Status: Merged
Merged: 11/13/2025
Merged by: @lnhsingh

Base: mainHead: sr/middleware-docs-refactor


📝 Commits (10+)

📊 Changes

8 files changed (+2944 additions, -2425 deletions)

View changed files

📝 pipeline/preprocessors/link_map.py (+11 -0)
📝 reference/python/docs/langchain/middleware.md (+123 -43)
📝 src/docs.json (+24 -2)
📝 src/oss/langchain/human-in-the-loop.mdx (+47 -4)
src/oss/langchain/middleware.mdx (+0 -2376)
src/oss/langchain/middleware/built-in.mdx (+1740 -0)
src/oss/langchain/middleware/custom.mdx (+914 -0)
src/oss/langchain/middleware/overview.mdx (+85 -0)

📄 Description

  • significant cleanup of API ref -- only listing init functions, also cleaning up tables of refs to various middlewares
  • breaking out middleware page into a middleware section with
    • overview
    • custom middlewares
    • prebuilt middlewares
  • custom middleware has consolidated content in python re "decorator vs class based" syntax
  • opted to keep config options bc we don't have great API refs for js

still todo:

  • general editing
    • I think we really want to focus on the "one liner" intros to each prebuilt
    • determine structure for individual middleware sections (do we like what's here? maybe we don't need the extended examples?)
    • need help w/ structure on the index page -- need more conceptual copy I think?
    • we have a diff HITL page that only uses this middleware, what to do about consolidation there?
  • api refs for js

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/langchain-ai/docs/pull/1382 **Author:** [@sydney-runkle](https://github.com/sydney-runkle) **Created:** 11/12/2025 **Status:** ✅ Merged **Merged:** 11/13/2025 **Merged by:** [@lnhsingh](https://github.com/lnhsingh) **Base:** `main` ← **Head:** `sr/middleware-docs-refactor` --- ### 📝 Commits (10+) - [`7a37adb`](https://github.com/langchain-ai/docs/commit/7a37adb270217a2d10f6646cc9adcdda59c05fea) changes - [`bbc93a3`](https://github.com/langchain-ai/docs/commit/bbc93a3e8e5eddc84ac97ee14c7ab7d1fe1a1ac8) finalizing - [`d9b799f`](https://github.com/langchain-ai/docs/commit/d9b799f46b52ebb4a2539eeb81fec153de775d77) Merge branch 'main' into sr/middleware-docs-refactor - [`54febe2`](https://github.com/langchain-ai/docs/commit/54febe25aa10a6ab6f4aaddde73a66ebbcf1843f) docs json fix - [`3b4739a`](https://github.com/langchain-ai/docs/commit/3b4739a275d93920b1a7006654fce9893ffb522d) no diff on ref pyproject - [`c9a593e`](https://github.com/langchain-ai/docs/commit/c9a593e5d4289897191268851b0c02cf74edafe6) links working - [`f863dfb`](https://github.com/langchain-ai/docs/commit/f863dfb448ba6db01784a09d56bfe10a54df5236) python only refs for now - [`7c56291`](https://github.com/langchain-ai/docs/commit/7c562910033a2a5fe7bce44c5a9780ccee38cf4c) overview - [`8c95f54`](https://github.com/langchain-ai/docs/commit/8c95f54eb3d51406bb8bc79873a2ecd31588054f) overview - [`a59570a`](https://github.com/langchain-ai/docs/commit/a59570a26590bdcab0275967dbdb31969368e407) edits ### 📊 Changes **8 files changed** (+2944 additions, -2425 deletions) <details> <summary>View changed files</summary> 📝 `pipeline/preprocessors/link_map.py` (+11 -0) 📝 `reference/python/docs/langchain/middleware.md` (+123 -43) 📝 `src/docs.json` (+24 -2) 📝 `src/oss/langchain/human-in-the-loop.mdx` (+47 -4) ➖ `src/oss/langchain/middleware.mdx` (+0 -2376) ➕ `src/oss/langchain/middleware/built-in.mdx` (+1740 -0) ➕ `src/oss/langchain/middleware/custom.mdx` (+914 -0) ➕ `src/oss/langchain/middleware/overview.mdx` (+85 -0) </details> ### 📄 Description * significant cleanup of API ref -- only listing init functions, also cleaning up tables of refs to various middlewares * breaking out middleware page into a middleware section with * overview * custom middlewares * prebuilt middlewares * custom middleware has consolidated content in python re "decorator vs class based" syntax * opted to keep config options bc we don't have great API refs for js still todo: * general editing * I think we really want to focus on the "one liner" intros to each prebuilt * determine structure for individual middleware sections (do we like what's here? maybe we don't need the extended examples?) * need help w/ structure on the index page -- need more conceptual copy I think? * we have a diff HITL page that only uses this middleware, what to do about consolidation there? * api refs for js --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
yindo added the pull-request label 2026-02-17 17:22:26 -05:00
yindo closed this issue 2026-02-17 17:22:26 -05:00
yindo changed title from [PR #1382] refactor: new middleware docs to [PR #1382] [MERGED] refactor: new middleware docs 2026-06-05 18:13:05 -04:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/docs#1516