holoviz / holoviz/hvplot

Points reference guide is not about points

Open
#897 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
1.4k
Forks
124
Avg merge
1d 18h
Merged PRs (30d)
1

Description

I'm trying to improve the docstring of `.points`. I don't really know what it is and how it differs from `scatter`. The docstring does not provide any helpful information currently either. So I jump to the reference documentation.

But the [Points Reference Documentation](https://hvplot.holoviz.org/reference/geopandas/points.html) does not explain what `points` is and how if differs from `scatter`. Furthermore it does not use `kind='points'` or `.hvplot.points` anywhere. It only showcases `geo=True`.

![image](https://user-images.githubusercontent.com/42288570/188203458-e8811bb4-31e7-4a87-b0d4-fe911a9a23e9.png)

From this I have no chance of understanding what `points` is. And I end up quite confused.

Please fix. Thanks.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.