pFad - Phone/Frame/Anonymizer/Declutterfier! Saves Data!


--- a PPN by Garber Painting Akron. With Image Size Reduction included!

URL: http://github.com/PlasmaPy/PlasmaPy/pull/2580

0.css" /> Add `docsig` as a `pre-commit` hook by namurphy · Pull Request #2580 · PlasmaPy/PlasmaPy · GitHub
Skip to content

Comments

Add docsig as a pre-commit hook#2580

Draft
namurphy wants to merge 7 commits intoPlasmaPy:mainfrom
namurphy:docsig
Draft

Add docsig as a pre-commit hook#2580
namurphy wants to merge 7 commits intoPlasmaPy:mainfrom
namurphy:docsig

Conversation

@namurphy
Copy link
Member

docsig is a tool to check signature params for proper documentation." Applying this would be another check on our documentation.

I'm leaning towards excluding tests from this check, largely because a test docstring is sometimes unnecessary if the name of the test fully indicates what the test is doing (i.e., when the name of the function is almost identical to what the docstring one-liner would say).

I'm creating this PR as a placeholder for later, since we probably want to fix problems with docstrings in more targeted PRs.

@github-actions github-actions bot added CI Related to continuous integration linters Code linters and autoformatters labels Mar 13, 2024
@github-actions github-actions bot added the packaging Related to packaging or distribution label Mar 14, 2024
@codecov
Copy link

codecov bot commented Mar 14, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 95.40%. Comparing base (8b617b8) to head (74355a6).

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #2580      +/-   ##
==========================================
+ Coverage   94.62%   95.40%   +0.78%     
==========================================
  Files         107      107              
  Lines        9667     9667              
  Branches     1466     1466              
==========================================
+ Hits         9147     9223      +76     
+ Misses        327      257      -70     
+ Partials      193      187       -6     

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

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@github-actions github-actions bot added docs PlasmaPy Docs at http://docs.plasmapy.org contributor guide labels Mar 15, 2024
@namurphy namurphy added this to the Future milestone Apr 9, 2024
@github-actions
Copy link

This pull request will be closed in 60 days due to a year of inactivity unless the stale label or comment is removed.

@github-actions github-actions bot added the Stale Dormant issues & PRs which will be automatically closed if the label is not removed. label Apr 19, 2025
@namurphy namurphy added the prototype 🏗️ Trying out an implementation on a trial basis label May 28, 2025
@github-actions github-actions bot removed the Stale Dormant issues & PRs which will be automatically closed if the label is not removed. label May 31, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CI Related to continuous integration contributor guide docs PlasmaPy Docs at http://docs.plasmapy.org linters Code linters and autoformatters packaging Related to packaging or distribution prototype 🏗️ Trying out an implementation on a trial basis

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

pFad - Phonifier reborn

Pfad - The Proxy pFad © 2024 Your Company Name. All rights reserved.





Check this box to remove all script contents from the fetched content.



Check this box to remove all images from the fetched content.


Check this box to remove all CSS styles from the fetched content.


Check this box to keep images inefficiently compressed and original size.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy