-
Notifications
You must be signed in to change notification settings - Fork 3k
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(elastricsearch): add description fiels #9693
docs(elastricsearch): add description fiels #9693
Conversation
e8dec55
to
ca86fac
Compare
) | ||
collapse_urns: CollapseUrns = Field( | ||
default_factory=CollapseUrns, | ||
default_factory=CollapseUrns, description="Urn of collapse." |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
In this case the problem seems to be in doc generation instead. CollapseUrns. urns_suffix_regex is documented properly. This documentation does not really explain the functionality.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Same for this #9690 ?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
That one I merged in. But urn of collapse
does not really tell what this is doing. The underlying model has more details which are useful but are not showing up in the docs. If you feel comfortable reviewing the docgen code and making changes in that please do. Otherwise someone in our team can attempt that when they get a chance.
c60f6d2
to
dd51020
Compare
dd51020
to
a17d3ad
Compare
Up @anshbansal please 🙏 |
In the long run we would like to fix this doc generation bug. In the short term I am merging this in as I understand it can cause confusion |
Add descriptions to elasticseach args
Checklist