Updating reference docs for new site

[mdrxy]

Hello!

This repo is part of LangChain's v0.3 reference documentation. As part of our efforts to consolidate all LangChain projects under one docs site, we are also consolidating the references to this new site. This repo will live at https://reference.langchain.com/python/integrations/langchain_postgres/

As part of the migration, we have switched from using Sphinx/reStructuredText to Material for MkDocs, which is a Markdown-based syntax. Consequently, the inline docstrings and reference docs in the langchain-postgres repo need to be updated accordingly. (Note: existing reference docs are frozen on the v0.3 branch of this repo).

Please update the following:

• .. code-block:: {LANGUAGE} admonitions should be translated to standard Markdown codeblocks, e.g.:

  ```language
  some code
  ```
  

• URLs with the format `Text to hyperlink <https://link.com>\`__ or `Text to hyperlink <https://link.com>\`_ should be replaced with markdown links like [Text to hyperlink](https://link.com)

• Double-backtick inline code like ``inline code`` should be replaced with single backticks like `inline code`

• Callout admonitions:

  • .. warning::, .. important::, and .. note:: should be updated to !!! warning "Optional title", !!! important, and !!! note respectively. (each can have an optional title). See docs.
  • Dropdowns like .. dropdown:: {TITLE} should be replaced with callouts and the ??? syntax. See docs.

• .. versionchanged:: x.y.z should be translated to !!! warning "Behavior changed in x.y.z" (with optional descriptions)

• .. versionadded:: x.y.z should be translated to !!! version-added "Added in version x.y.z" (with optional descriptions)

• .. deprecated:: x.y.z should be translated to !!! deprecated

• :private: directives should be removed. New reference docs will automatically exclude methods prefixed with a single underscore, e.g. _function()

  • If there are functions that do not use this syntax or can not be updated to use it, we are able to filter out functions by name. Reach out and I can help.

• Any cross references with :func:, :class:, or :meth: should be updated to use Markdown links, e.g.: [Runtime][langgraph.runtime.Runtime]

[bulolo]

is there any way to run on langchain==1.0.0aX?

uv add langchain-postgres==0.0.15
  × No solution found when resolving dependencies for split (markers: python_full_version == '3.12.*'):
  ╰─▶ Because langchain-postgres==0.0.15 depends on langchain-core>=0.2.13,<0.4.0 and your project depends on
      langchain-core==1.0.0a8, we can conclude that your project and langchain-postgres==0.0.15 are incompatible.
      And because your project depends on langchain-postgres==0.0.15, we can conclude that your project's requirements are
      unsatisfiable.
  help: If you want to add the package regardless of the failed resolution, provide the `--frozen` flag to skip locking and
        syncing.