10/14 ref work

.github/CONTRIBUTING.md

@@ -1,6 +1,6 @@
 # Contributing to LangChain Docs
 
-Please read our [contributing guide](https://docs.langchain.com/docs/contributing) to learn how you can make a contribution to the LangChain documentation.
+Please read our [contributing guide](https://docs.langchain.com/oss/python/contributing/overview) to learn how you can make a contribution to the LangChain ecosystem and documentation.
 
 Happy writing!
 🎤🦜

.github/ISSUE_TEMPLATE/04-langchain-labs.yml

@@ -0,0 +1,36 @@
+name: LangChain Labs Documentation
+description: Report an issue related to the LangChain Labs documentation.
+title: "[langchain-labs]: <Please write a comprehensive title>"
+labels: [langchain-labs]
+
+body:
+  - type: dropdown
+    attributes:
+      label: "Type of issue"
+      description: "What type of documentation issue are you reporting?"
+      options:
+        - issue / bug
+        - request for content
+        - question
+        - other
+      default: 0
+    validations:
+      required: true
+  - type: dropdown
+    attributes:
+      label: "Language"
+      description: "What language is the documentation issue related to?"
+      options:
+        - Python
+        - JavaScript
+        - N/A
+      default: 0
+  - type: textarea
+    attributes:
+      label: "Description"
+      description: >
+        Please describe your issue, content request, or question in detail.
+        If reporting an issue with current documentation, please include a reference
+        to the specific document/code you're referring to.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/05-reference-docs.yml

@@ -0,0 +1,54 @@
+name: Reference Documentation
+description: Report an issue related to API reference documentation.
+title: "[reference]: <Please write a comprehensive title>"
+labels: [reference]
+
+body:
+  - type: dropdown
+    attributes:
+      label: "Type of issue"
+      description: "What type of reference documentation issue are you reporting?"
+      options:
+        - issue / bug
+        - missing documentation
+        - incorrect type signature
+        - outdated/deprecated content
+        - other
+      default: 0
+    validations:
+      required: true
+  - type: dropdown
+    attributes:
+      label: "Language"
+      description: "What language is the reference documentation issue related to?"
+      options:
+        - Python
+        - JavaScript
+        - N/A
+      default: 0
+    validations:
+      required: true
+  - type: dropdown
+    attributes:
+      label: "Product"
+      description: "Which product's reference docs is this issue related to?"
+      options:
+        - LangChain
+        - LangGraph
+        - LangSmith
+        - Other
+      default: 0
+  - type: input
+    attributes:
+      label: "Link to reference page"
+      description: "URL to the specific reference page with the issue (if applicable)"
+  - type: textarea
+    attributes:
+      label: "Description"
+      description: >
+        Please describe your issue in detail.
+        For missing documentation, specify the class/method/function that needs documentation.
+        For incorrect signatures, provide the expected vs. actual signature.
+        For bugs, include what you expected to see vs. what you actually see.
+    validations:
+      required: true

IDE_SETUP.md

@@ -2,6 +2,8 @@
 
 This repository includes configuration files to ensure consistent formatting across different editors and IDEs used by documentation writers.
 
+Ensure the following steps are taken and configurations are in place before making substantial docs changes.
+
 ## Automatic Configuration
 
 ### VSCode

README.md

@@ -57,11 +57,14 @@ Built files are stored in `/reference/dist/{LANGUAGE}`, which is then deployed t
 
 ## Contributing
 
-The following steps refer to the [`docs.langchain.com`](https://docs.langchain.com) Mintlify documentation site. For contributing to the reference docs, see the `README.md` files in `/reference/python` and `/reference/javascript`.
+Before making any changes, we encourage you to read the LangChain [contributing guide](https://docs.langchain.com/oss/python/contributing/documentation) to understand our documentation types and their writing and quality standards.
 
-### Set up a dev environment
+> [!IMPORTANT]
+> The following steps refer to the [`docs.langchain.com`](https://docs.langchain.com) Mintlify documentation site. For contributing to reference docs, see the `README.md` file in the `/reference/python` and `/reference/javascript` directories.
+
+### Set up a local dev environment
 
-1. Clone this repo. Ensure the steps in [IDE_SETUP.md](./IDE_SETUP.md) are followed to configure your IDE/editor to automatically apply the correct settings.
+1. Clone this repo. Follow the steps outlined in [IDE_SETUP.md](./IDE_SETUP.md).
 2. Install `uv` from <https://docs.astral.sh/uv/> (if not already installed)
 3. Install `npm` from <https://nodejs.org/en/download/> (if not already installed)
 4. Create and activate a virtual environment:
@@ -121,7 +124,7 @@ Common commands:
 * `make lint_md_fix` - Lint and fix markdown files
 * `make help` - Show all available commands
 
-#### docs CLI Tool
+#### `docs` CLI Tool
 
 The `docs` command (installed as `uv run docs`) provides additional functionality:
 
@@ -153,12 +156,12 @@ These can be used directly using the `Makefile` or via the `docs` CLI tool:
 ### File formats
 
 * **Markdown files** (`.md`, `.mdx`) - Standard documentation content
-* **Jupyter notebooks** (`.ipynb`) - Converted to markdown during build, though **these are not recommended for new content!**
+* **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
 
 ### Documentation syntax
 
-This project uses [Mintlify](https://mintlify.com/docs) for documentation generation. Key features:
+Our primary docs the [Mintlify](https://mintlify.com/docs) platform for docs generation. Key features include:
 
 * **Frontmatter** - YAML metadata at the top of files
 * **Components** - Special Mintlify components for enhanced formatting
@@ -250,7 +253,7 @@ Once your branch has been merged into `main`, you need to push the changes to `p
 
 ### `docs dev` not working / running
 
-Re-do the [steps to set up your dev environment](#set-up-a-dev-environment), ensuring you have activated the virtual environment and installed all dependencies.
+Re-do the [steps to set up your dev environment](#set-up-a-local-dev-environment), ensuring you have activated the virtual environment and installed all dependencies.
 
 ### Mintlify `.venv` parsing error
 

reference/python/README.md

@@ -35,6 +35,7 @@ This site is currently being migrated from a previous Sphinx-based implementatio
 - [ ] Fix `navigation.path` feature/plugin in `mkdocs.yml` not working
 - [ ] Resolve Griffe errors
 - [ ] Set up CI to fail on unexpected Griffe warnings
+- [ ] "Module last updated" auto-generation for module pages using source file commit timestamps or the MkDocs plugin [git-revision-date-localized](https://github.com/timvink/mkdocs-git-revision-date-localized-plugin)
 - [ ] Fix search magnifying glass icon color in dark mode
 - [ ] Copy page support (need to add a post-processing step to generate markdown files to serve alongside the API reference docs)
 - [ ] Language switcher (JS/TS)

reference/python/docs/index.md

@@ -5,7 +5,7 @@ title: LangChain Python Reference
 Welcome to the [LangChain](https://langchain.com) Python reference documentation! These pages detail the core interfaces you will use when building applications with LangChain and LangGraph. Each section covers a different part of the ecosystem
 
 !!! warning "Work in progress"
-    This site is a work in progress. If you have any suggestions or find any issues, please [open an issue on GitHub](https://github.com/langchain-ai/docs/issues).
+    This site is a work in progress. If you have any suggestions or find any issues, please [open an issue on GitHub](https://github.com/langchain-ai/docs/issues/new?template=05-reference-docs.yml).
 
 !!! note "Reference docs"
     This site contains **Python reference documentation**. You can find **conceptual guides, tutorials, and more** in the [main LangChain documentation site](https://docs.langchain.com).
@@ -15,5 +15,5 @@ Welcome to the [LangChain](https://langchain.com) Python reference documentation
 !!! info "Looking for legacy docs?"
     Legacy docs and API references are available for:
 
-    - [LangChain](https://python.langchain.com/).
-    - [LangGraph](https://langchain-ai.github.io/langgraph/).
+    - [LangChain](https://python.langchain.com/)
+    - [LangGraph](https://langchain-ai.github.io/langgraph/)

reference/python/docs/integrations/langchain_anthropic.md

@@ -4,4 +4,8 @@ title: Anthropic - LangChain Integration Reference
 
 # :simple-claude:{ .lg .middle } `langchain-anthropic`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-anthropic?label=%20)](https://pypi.org/project/langchain-anthropic/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-anthropic)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-anthropic)](https://pypistats.org/packages/langchain-anthropic)
+
 ::: langchain_anthropic

reference/python/docs/integrations/langchain_astradb.md

@@ -4,4 +4,8 @@ title: AstraDB - LangChain Integration Reference
 
 # :simple-datastax:{ .lg .middle } `langchain-astradb`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-astradb?label=%20)](https://pypi.org/project/langchain-astradb/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-astradb)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-astradb)](https://pypistats.org/packages/langchain-astradb)
+
 ::: langchain_astradb

reference/python/docs/integrations/langchain_aws.md

@@ -4,4 +4,8 @@ title: AWS - LangChain Integration Reference
 
 # :material-aws:{ .lg .middle } `langchain-aws`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-aws?label=%20)](https://pypi.org/project/langchain-aws/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-aws)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-aws)](https://pypistats.org/packages/langchain-aws)
+
 ::: langchain_aws

reference/python/docs/integrations/langchain_azure_ai.md

@@ -4,4 +4,8 @@ title: Azure AI - LangChain Integration Reference
 
 # :material-microsoft-azure:{ .lg .middle } `langchain-azure-ai`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-azure-ai?label=%20)](https://pypi.org/project/langchain-azure-ai/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-azure-ai)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-azure-ai)](https://pypistats.org/packages/langchain-azure-ai)
+
 This package ref has not yet been migrated to v1. See the [old ref](https://python.langchain.com/api_reference/azure_ai/index.html).

reference/python/docs/integrations/langchain_azure_dynamic_sessions.md

@@ -4,4 +4,8 @@ title: Azure Dynamic Sessions - LangChain Integration Reference
 
 # :material-microsoft-azure:{ .lg .middle } `langchain-azure-dynamic-sessions`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-azure-dynamic-sessions?label=%20)](https://pypi.org/project/langchain-azure-dynamic-sessions/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-azure-dynamic-sessions)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-azure-dynamic-sessions)](https://pypistats.org/packages/langchain-azure-dynamic-sessions)
+
 This package ref has not yet been migrated to v1. See the [old ref](https://python.langchain.com/api_reference/azure_dynamic_sessions/index.html).

reference/python/docs/integrations/langchain_cerebras.md

@@ -4,4 +4,8 @@ title: Cerebras - LangChain Integration Reference
 
 # `langchain-cerebras`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-cerebras?label=%20)](https://pypi.org/project/langchain-cerebras/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-cerebras)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-cerebras)](https://pypistats.org/packages/langchain-cerebras)
+
 This package ref has not yet been migrated to v1. See the [old ref](https://python.langchain.com/api_reference/cerebras/index.html).

reference/python/docs/integrations/langchain_chroma.md

@@ -4,4 +4,8 @@ title: Chroma - LangChain Integration Reference
 
 # `langchain-chroma`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-chroma?label=%20)](https://pypi.org/project/langchain-chroma/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-chroma)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-chroma)](https://pypistats.org/packages/langchain-chroma)
+
 ::: langchain_chroma

reference/python/docs/integrations/langchain_cohere.md

@@ -4,4 +4,8 @@ title: Cohere - LangChain Integration Reference
 
 # `langchain-cohere`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-cohere?label=%20)](https://pypi.org/project/langchain-cohere/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-cohere)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-cohere)](https://pypistats.org/packages/langchain-cohere)
+
 This package ref has not yet been migrated to v1. See the [old ref](https://python.langchain.com/api_reference/cohere/index.html).

reference/python/docs/integrations/langchain_db2.md

@@ -4,4 +4,8 @@ title: Db2 - LangChain Integration Reference
 
 # `langchain-db2`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-db2?label=%20)](https://pypi.org/project/langchain-db2/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-db2)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-db2)](https://pypistats.org/packages/langchain-db2)
+
 This package ref has not yet been migrated to v1. See the [old ref](https://python.langchain.com/api_reference/db2/index.html).

reference/python/docs/integrations/langchain_deepseek.md

@@ -4,4 +4,8 @@ title: DeepSeek - LangChain Integration Reference
 
 # `langchain-deepseek`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-deepseek?label=%20)](https://pypi.org/project/langchain-deepseek/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-deepseek)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-deepseek)](https://pypistats.org/packages/langchain-deepseek)
+
 ::: langchain_deepseek

reference/python/docs/integrations/langchain_elasticsearch.md

@@ -4,4 +4,8 @@ title: Elasticsearch - LangChain Integration Reference
 
 # :simple-elasticsearch:{ .lg .middle } `langchain-elasticsearch`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-elasticsearch?label=%20)](https://pypi.org/project/langchain-elasticsearch/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-elasticsearch)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-elasticsearch)](https://pypistats.org/packages/langchain-elasticsearch)
+
 This package ref has not yet been migrated to v1. See the [old ref](https://python.langchain.com/api_reference/elasticsearch/index.html).

reference/python/docs/integrations/langchain_exa.md

@@ -4,4 +4,8 @@ title: Exa - LangChain Integration Reference
 
 # `langchain-exa`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-exa?label=%20)](https://pypi.org/project/langchain-exa/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-exa)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-exa)](https://pypistats.org/packages/langchain-exa)
+
 ::: langchain_exa

reference/python/docs/integrations/langchain_fireworks.md

@@ -4,4 +4,8 @@ title: Fireworks - LangChain Integration Reference
 
 # `langchain-fireworks`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-fireworks?label=%20)](https://pypi.org/project/langchain-fireworks/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-fireworks)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-fireworks)](https://pypistats.org/packages/langchain-fireworks)
+
 ::: langchain_fireworks

reference/python/docs/integrations/langchain_google_community.md

@@ -4,4 +4,8 @@ title: Google (Community) - LangChain Integration Reference
 
 # `langchain-google-community`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-google-community?label=%20)](https://pypi.org/project/langchain-google-community/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-google-community)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-google-community)](https://pypistats.org/packages/langchain-google-community)
+
 ::: langchain_google_community

reference/python/docs/integrations/langchain_google_genai.md

@@ -4,4 +4,8 @@ title: Google (GenAI) - LangChain Integration Reference
 
 # :simple-googlegemini:{ .lg .middle } `langchain-google-genai`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-google-genai?label=%20)](https://pypi.org/project/langchain-google-genai/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-google-genai)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-google-genai)](https://pypistats.org/packages/langchain-google-genai)
+
 ::: langchain_google_genai

reference/python/docs/integrations/langchain_google_vertexai.md

@@ -4,4 +4,8 @@ title: Google (VertexAI) - LangChain Integration Reference
 
 # :simple-googlecloud:{ .lg .middle } `langchain-google-vertexai`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-google-vertexai?label=%20)](https://pypi.org/project/langchain-google-vertexai/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-google-vertexai)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-google-vertexai)](https://pypistats.org/packages/langchain-google-vertexai)
+
 ::: langchain_google_vertexai

reference/python/docs/integrations/langchain_groq.md

@@ -4,4 +4,8 @@ title: Groq - LangChain Integration Reference
 
 # `langchain-groq`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-groq?label=%20)](https://pypi.org/project/langchain-groq/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-groq)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-groq)](https://pypistats.org/packages/langchain-groq)
+
 ::: langchain_groq

reference/python/docs/integrations/langchain_huggingface.md

@@ -4,4 +4,8 @@ title: HuggingFace - LangChain Integration Reference
 
 # :simple-huggingface:{ .lg .middle } `langchain-huggingface`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-huggingface?label=%20)](https://pypi.org/project/langchain-huggingface/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-huggingface)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-huggingface)](https://pypistats.org/packages/langchain-huggingface)
+
 This package ref has not yet been migrated to v1. See the [old ref](https://python.langchain.com/api_reference/huggingface/index.html).

reference/python/docs/integrations/langchain_ibm.md

@@ -4,4 +4,8 @@ title: IBM - LangChain Integration Reference
 
 # `langchain-ibm`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-ibm?label=%20)](https://pypi.org/project/langchain-ibm/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-ibm)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-ibm)](https://pypistats.org/packages/langchain-ibm)
+
 This package ref has not yet been migrated to v1. See the [old ref](https://python.langchain.com/api_reference/ibm/index.html).

reference/python/docs/integrations/langchain_milvus.md

@@ -4,4 +4,8 @@ title: Milvus - LangChain Integration Reference
 
 # :simple-milvus:{ .lg .middle } `langchain-milvus`
 
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-milvus?label=%20)](https://pypi.org/project/langchain-milvus/#history)
+[![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)
+
 This package ref has not yet been migrated to v1.