Skip to content

Document the data options #1555

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

Merged
merged 25 commits into from
May 13, 2025
Merged

Document the data options #1555

merged 25 commits into from
May 13, 2025

Conversation

Azaya89
Copy link
Collaborator

@Azaya89 Azaya89 commented Apr 29, 2025

fixes #1538

This PR documents the Data Options in the new API reference guide.

@Azaya89 Azaya89 requested a review from maximlt April 29, 2025 18:06
@Azaya89 Azaya89 self-assigned this Apr 29, 2025
@Azaya89 Azaya89 added the NF SDG 2025 NumFocus Software Development Grant 2025 label Apr 29, 2025
Copy link
Member

@maximlt maximlt left a comment

Choose a reason for hiding this comment

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

I've pushed a few changes:

  • Using one rst admonition in the converter docstring
  • Format the code
  • Update a couple of links to HoloViews to avoid pointing to the reference but to the gallery instead as it's more user-friendly
  • Fix broken links (building the docs showed 8 warnings) by declaring MyST explicit targets and using them
  • Use seealso admonition on the data page as it looks prettier

Comment on lines +155 to +156
.. note::
``group_label`` only applies when plotting multiple columns and does not control grouping with ``by``.
Copy link
Member

Choose a reason for hiding this comment

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

The docs immediately look much better when using rst admonitions in the converter docstring, don't hesitate to use them more.

image

@maximlt maximlt merged commit c6977ae into main May 13, 2025
11 checks passed
@maximlt maximlt deleted the data-op branch May 13, 2025 12:46
@Azaya89
Copy link
Collaborator Author

Azaya89 commented May 13, 2025

Thanks, I'll incorporate these additions to the new PRs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
NF SDG 2025 NumFocus Software Development Grant 2025
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Document the data options
2 participants