Skip to content
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

Added sphinx documentation for data shifts routine. #131

Merged
merged 11 commits into from
Aug 2, 2022

Conversation

kperrynrel
Copy link
Collaborator

Description

Thank you for your contribution! Please provide a brief description of the problem and the proposed solution or new feature (if not already fully described in a linked issue)

Checklist

This PR is dependent on PR #124. It contains the Sphinx documentation for the data shift algorithm.

The following items must be addressed before the code can be merged.
Please don't hesitate to ask for help if you are unsure of how to accomplish any of the items.
You are free to remove any checklist items that do not apply or add additional items that are
not on this list

  • Clearly documented all new API functions with PEP257 and numpydoc compliant docstrings
  • Adds description and name entries in the appropriate "what's new" file
    in docs/whatsnew
    for all changes. Includes link to the GitHub Issue with :issue:`num`
    or this Pull Request with :pull:`num`. Includes contributor name
    and/or GitHub username (link with :ghuser:`user`).
  • Non-API functions clearly documented with docstrings or comments as necessary
  • Pull request is nearly complete and ready for detailed review

@kperrynrel kperrynrel changed the title add in data shift sphinx documentation. Added sphinx documentation for data shifts routine. Feb 17, 2022
Copy link
Member

@kandersolar kandersolar left a comment

Choose a reason for hiding this comment

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

The docs build is going to fail here until #124 is merged, so I think we should wait on doing a real review until then, but I built it locally and it looks pretty good! Here are some comments in the meantime.

docs/examples/data-shifts.py Outdated Show resolved Hide resolved
docs/examples/data-shifts.py Outdated Show resolved Hide resolved
docs/examples/data-shifts.py Outdated Show resolved Hide resolved
docs/examples/data-shifts.py Show resolved Hide resolved
Co-authored-by: Kevin Anderson <57452607+kanderso-nrel@users.noreply.github.com>
docs/whatsnew/0.1.1.rst Outdated Show resolved Hide resolved
@kandersolar
Copy link
Member

kandersolar commented Jun 24, 2022

@kperrynrel I think the docs build failure will be resolved by adding a new item - optional under - doc in this bullet list in the RTD config:

extra_requirements:
- doc

@kperrynrel
Copy link
Collaborator Author

@kanderso-nrel thanks for the tip on the readthedocs.yml--that would've taken me hours to debug!!

@kperrynrel
Copy link
Collaborator Author

@kanderso-nrel I'd say things are looking good for review at this point! Let me know what you think.

Copy link
Member

@kandersolar kandersolar left a comment

Choose a reason for hiding this comment

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

Thanks @kperrynrel, here are some suggestions. FYI there are a couple comments earlier in the thread that are still relevant today.

docs/examples/data-shifts.py Outdated Show resolved Hide resolved
docs/examples/data-shifts.py Outdated Show resolved Hide resolved
docs/examples/data-shifts.py Show resolved Hide resolved
@kandersolar kandersolar added this to the v0.1.2 milestone Jun 27, 2022
@kandersolar kandersolar added the documentation Improvements or additions to documentation label Jun 27, 2022
Copy link
Member

@kandersolar kandersolar left a comment

Choose a reason for hiding this comment

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

LGTM, thanks @kperrynrel!

@kperrynrel kperrynrel requested a review from cwhanse June 29, 2022 15:35
@kperrynrel kperrynrel linked an issue Jul 1, 2022 that may be closed by this pull request
@kandersolar kandersolar mentioned this pull request Jul 26, 2022
8 tasks
Copy link
Member

@cwhanse cwhanse left a comment

Choose a reason for hiding this comment

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

Sorry for the delay @kperrynrel

@kperrynrel kperrynrel merged commit 61e0f54 into pvlib:master Aug 2, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Adding Sphinx examples for each of the QA modules in the package.
3 participants