Skip to content

Conversation

@mwcraig
Copy link
Member

@mwcraig mwcraig commented Jun 26, 2025

Fixes #51

@mwcraig mwcraig requested a review from Copilot June 26, 2025 18:42
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This pull request updates the API interface documentation for the astro image display to better describe the expected GUI behavior. It enhances docstrings by adding "Notes" sections to clarify how methods affect the display of images and markers.

  • Improved documentation in load_image, set_cuts, get_cuts, set_stretch, get_stretch, set_colormap, get_colormap, save, load_catalog, set_catalog_style, get_catalog_style, get_catalog, get_catalog_names, set_viewport, and get_viewport methods.
  • Added guidance on which methods update the image display and which do not.
Comments suppressed due to low confidence (1)

src/astro_image_display_api/interface_definition.py:53

  • [nitpick] Consider clarifying what criteria or parameters define an 'appropriate viewport' to set clearer expectations for implementers.
        Loading an image should also set an appropriate viewport for that image.

@mwcraig mwcraig force-pushed the add-gui-effects-to-docstrings branch from 7478fb8 to bd983c8 Compare June 30, 2025 17:03
@mwcraig mwcraig force-pushed the add-gui-effects-to-docstrings branch from bd983c8 to 48a205d Compare June 30, 2025 17:06
@mwcraig mwcraig merged commit 6e8e66b into astropy:main Jun 30, 2025
7 checks passed
@mwcraig mwcraig deleted the add-gui-effects-to-docstrings branch June 30, 2025 17:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add expected frontend behavior to the Notes section of the docstring

1 participant