Skip to content

Add docstrings needed to help a user create a simple Scatter example #5363

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

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

MarcSkovMadsen
Copy link
Collaborator

This addresses a small part of #5361 by adding docstrings to Scatter and .opts as well as updating the docstring of Opts.

For me this makes it so much easier to understand the objects and navigate the documentation.

holoviews-docstring-improvements.mp4

dependent relationships between the x and y axes in two-dimensional space,
such as Chart types like `Curve`.

Reference: [Bokeh](http://holoviews.org/reference/elements/bokeh/Scatter.html), [Matplotlib](http://holoviews.org/reference/elements/matplotlib/Scatter.html), [Plotly](http://holoviews.org/reference/elements/plotly/Scatter.html)
Copy link
Member

Choose a reason for hiding this comment

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

Markdown won't work sadly.

Copy link
Member

Choose a reason for hiding this comment

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

What link formatting will work? I'd be happy to see this merged once the links are formatted in a usable way.

Copy link
Member

Choose a reason for hiding this comment

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

I think markdown is fine for vs code tooltips but for ref API I think it needs to be reST

@codecov codecov bot deleted a comment from codecov-commenter May 17, 2024
@hoxbro hoxbro added the type: docs Related to the documentation and examples label May 17, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type: docs Related to the documentation and examples
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants