Skip to content

Improved Docstrings & Type Hints in Grid #1226

New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

Draft
wants to merge 6 commits into
base: main
Choose a base branch
from
Draft

Improved Docstrings & Type Hints in Grid #1226

wants to merge 6 commits into from

Conversation

philipc2
Copy link
Member

@philipc2 philipc2 commented Apr 26, 2025

Overview

  • Updates docstrings and documentation to use Sphinx roles
  • Added extra context to many docstrings, including core grid variables
  • Improved type hinting

@philipc2 philipc2 self-assigned this Apr 26, 2025
@philipc2 philipc2 added the documentation Improvements or additions to documentation label Apr 26, 2025
@philipc2 philipc2 requested a review from Copilot May 6, 2025 03:28
Copy link
Contributor

@Copilot 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 PR improves documentation and docstrings while enhancing type hinting in the grid utility functions.

  • Updated documentation to use Sphinx roles and provide extra context for core grid variables
  • Added a new setter generator function ("make_setter") with type-checking for xarray DataArrays
  • Improved overall type hinting in the module

@philipc2 philipc2 changed the title DRAFT: Documentation Updates & Improved Docstrings Documentation Updates & Improved Docstrings May 6, 2025
@philipc2 philipc2 changed the title Documentation Updates & Improved Docstrings Improved Docstrings & Type Hints in Grid May 6, 2025
# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant