Skip to content

Doc strings reformatting #762

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 8 commits into from
Jan 9, 2024
Merged

Doc strings reformatting #762

merged 8 commits into from
Jan 9, 2024

Conversation

mschwamb
Copy link
Collaborator

@mschwamb mschwamb commented Dec 30, 2023

Reformat doc strings so that they match the required format for the LINCC Framesworks incubator template setup for our documentation sphinx setup (which follows the numpy standard https://numpydoc.readthedocs.io/en/latest/format.html)

Fixes #142

Reformat doc strings so that they match the required format for the LINCC Framesworks incubator template setup for our documentation sphinx setup (which follows the numpy standard https://numpydoc.readthedocs.io/en/latest/format.html)
@mschwamb mschwamb changed the title Doc strings reformatting - WIP WIP: Doc strings reformatting Dec 30, 2023
Copy link

codecov bot commented Dec 30, 2023

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (3a4b0b5) 74.67% compared to head (09897ad) 74.69%.
Report is 5 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #762      +/-   ##
==========================================
+ Coverage   74.67%   74.69%   +0.01%     
==========================================
  Files          66       66              
  Lines        3029     3031       +2     
==========================================
+ Hits         2262     2264       +2     
  Misses        767      767              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

update more doc strings to be in compliance with the format
finish adjustments to doc strings in  PPVignetting.py
updating remaining file docstrings to try and get them to be as standarized as possible and generate in readthedocs
black ObjectDataReaderpy
update readme with standard for docstrings
@mschwamb mschwamb changed the title WIP: Doc strings reformatting Doc strings reformatting Dec 31, 2023
@mschwamb
Copy link
Collaborator Author

All docstrings are standardized as close as I can get them and follow the NumPy format so they now render in read the docs.

had updated name in the utility to move away from SPP name.
fix change to default table name
A dictionary with pixel indices as keys and lists of ObjIDs for
those objects in each HEALPix tile as values. One of these
calculations is called a 'picket', as one element of a long picket
fence. At present,
Copy link
Contributor

Choose a reason for hiding this comment

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

There's an unfinished sentence here.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

It was in there to begin with. So I think let's leave it and let it get addressed in #763

Copy link
Contributor

@astronomerritt astronomerritt left a comment

Choose a reason for hiding this comment

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

Amazing. Must have been a lengthy and tedious job!

@mschwamb mschwamb merged commit f3ed452 into main Jan 9, 2024
@mschwamb mschwamb deleted the tests_readme_updates branch January 9, 2024 12:42
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.

checking/updating doc strings
2 participants