Skip to content

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

3 participants