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
Upgrade pydoc-markdown
#2117
Upgrade pydoc-markdown
#2117
Conversation
@ZanSara I tested the new pydoc-markdown version some month ago. I remember that there were some issues with generating arguments. They were not rendered properly. Let's check how they are rendered on haystack.deepset.ai. |
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.
Rather than unpinning the version, I'd suggest to pin the latest major release if it renders correctly.
You're right @PiffPaffM, I've made a test deployment from the branch and indeed there are rendering issues: https://haystack-website-c7z7lp2nb-deepset-overnice.vercel.app/reference/primitives I'll try to fix it and keep testing there. |
…ck into upgrade-pydoc-markdown
…ck into upgrade-pydoc-markdown
@PiffPaffM I think I managed to get https://haystack-website-6u1fqzxin-deepset-overnice.vercel.app/reference/crawler |
…o the local branch
…t from always show the pipeline as green
…ck into upgrade-pydoc-markdown
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.
The rendered content looks good! Thanks for updating it.
…pes-PyYAML and pydoc-markdown
…ck into upgrade-pydoc-markdown
pydoc-markdown
was pinned to a 3.x version, while version 4.x are now stable since a while.I propose to upgrade
pydoc-markdown
to make it compatible with Black: in this way, the same bot can apply code and documentation changes in a single commit and reduce the overall commit noise.In addition, the latest
pydoc-markdown
seems to introduce some neat improvements, like permalinks to every method (not present before)