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

DOC Add intersphinx linking to docs #97

Merged
merged 1 commit into from
Aug 12, 2022

Conversation

BenjaminBossan
Copy link
Collaborator

@BenjaminBossan BenjaminBossan commented Aug 12, 2022

Fixes #93

With this extension, skops docs can link, for instance, to the sklearn
docs.

On top of adding the extension, I made the following changes:

  • Adjust links to external docs where appropriate
  • Fix minor issues I found in the docs
  • Remove autodocs for type annotations, as they were redundant with the
    docstrings (but less detailed)

With this extension, skops docs can link, for instance, to the sklearn
docs.

On top of adding the extension, I made the following changes:

- Adjust links to external docs where appropriate
- Fix minor issues I found in the docs
- Remove autodocs for type annotations, as they were redundant with the
  docstrings (but less detailed)
@BenjaminBossan
Copy link
Collaborator Author

@skops-dev/maintainers Ready for review. Built docs are here.

Copy link
Member

@adrinjalali adrinjalali left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice refinements. Merging, more fixes (if any) can be added later. Thanks @BenjaminBossan

"sklearn": ("https://scikit-learn.org/stable/", None),
"pandas": ("https://pandas.pydata.org/docs/", None),
"joblib": ("https://joblib.readthedocs.io/en/latest/", None),
"huggingface_hub": ("https://huggingface.co/docs/huggingface_hub/main/en", None),
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

does this actually work?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, it works indeed :)

See here, at the bottom the link to huggingface_hub.snapshot_download

@adrinjalali adrinjalali merged commit 5780629 into skops-dev:main Aug 12, 2022
@BenjaminBossan BenjaminBossan deleted the docs-intersphinx-linking branch August 12, 2022 12:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

DOC Add intersphinx extension
2 participants