Skip to content

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

Open
MarcSkovMadsen wants to merge 2 commits intomainfrom
feature/scatter-docs
Open

Add docstrings needed to help a user create a simple Scatter example#5363
MarcSkovMadsen wants to merge 2 commits intomainfrom
feature/scatter-docs

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