Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Add typehints in both signature and description of API docs #17815

Merged
merged 1 commit into from Feb 20, 2024

Conversation

cbornet
Copy link
Collaborator

@cbornet cbornet commented Feb 20, 2024

This way we can document APIs in methods signature only where they are checked by the typing system and we get them also in the param description without having to duplicate in the docstrings (where they are unchecked).

Twitter: @cbornet_

@dosubot dosubot bot added the size:XS This PR changes 0-9 lines, ignoring generated files. label Feb 20, 2024
Copy link

vercel bot commented Feb 20, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
langchain ✅ Ready (Inspect) Visit Preview 💬 Add feedback Feb 20, 2024 4:47pm

@dosubot dosubot bot added the 🤖:docs Changes to documentation and examples, like .md, .rst, .ipynb files. Changes to the docs/ folder label Feb 20, 2024
@eyurtsev eyurtsev self-assigned this Feb 20, 2024
@eyurtsev eyurtsev merged commit 33555e5 into langchain-ai:master Feb 20, 2024
7 checks passed
@cbornet cbornet deleted the autodoc-typehints-both branch February 20, 2024 19:44
k8si pushed a commit to Mozilla-Ocho/langchain that referenced this pull request Feb 22, 2024
…ngchain-ai#17815)

This way we can document APIs in methods signature only where they are
checked by the typing system and we get them also in the param
description without having to duplicate in the docstrings (where they
are unchecked).

Twitter: @cbornet_
al1p pushed a commit to al1p/langchain that referenced this pull request Feb 27, 2024
…ngchain-ai#17815)

This way we can document APIs in methods signature only where they are
checked by the typing system and we get them also in the param
description without having to duplicate in the docstrings (where they
are unchecked).

Twitter: @cbornet_
haydeniw pushed a commit to haydeniw/langchain that referenced this pull request Feb 27, 2024
…ngchain-ai#17815)

This way we can document APIs in methods signature only where they are
checked by the typing system and we get them also in the param
description without having to duplicate in the docstrings (where they
are unchecked).

Twitter: @cbornet_
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
🤖:docs Changes to documentation and examples, like .md, .rst, .ipynb files. Changes to the docs/ folder size:XS This PR changes 0-9 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants