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

Trust Region docstrings improvement #197

Merged
merged 6 commits into from
Jul 30, 2023

Conversation

yash2798
Copy link
Member

No description provided.

@codecov
Copy link

codecov bot commented Jul 25, 2023

Codecov Report

Merging #197 (496afd3) into master (25fbd71) will increase coverage by 2.08%.
The diff coverage is n/a.

❗ Current head 496afd3 differs from pull request most recent head f76ba68. Consider uploading reports for the commit f76ba68 to get more accurate results

@@            Coverage Diff             @@
##           master     #197      +/-   ##
==========================================
+ Coverage   91.64%   93.73%   +2.08%     
==========================================
  Files           7        7              
  Lines         718      718              
==========================================
+ Hits          658      673      +15     
+ Misses         60       45      -15     
Files Changed Coverage Δ
src/trustRegion.jl 96.95% <ø> (+1.01%) ⬆️

... and 3 files with indirect coverage changes

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

@yash2798 yash2798 changed the title [WIP] Trust Region docstrings and documentation improvement Trust Region docstrings and documentation improvement Jul 26, 2023
@yash2798 yash2798 marked this pull request as ready for review July 26, 2023 00:53
@yash2798 yash2798 changed the title Trust Region docstrings and documentation improvement Trust Region docstrings improvement Jul 26, 2023
@yash2798
Copy link
Member Author

@ChrisRackauckas this can be merged

@@ -88,6 +85,14 @@ for large-scale and numerically-difficult nonlinear systems.
Currently, the linear solver and chunk size choice only applies to in-place defined
`NonlinearProblem`s. That is expected to change in the future.
"""
EnumX.@enumx RadiusUpdateSchemes begin
Copy link
Member

Choose a reason for hiding this comment

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

why was this moved? This puts the docstrong on the wrong object.

Copy link
Member Author

Choose a reason for hiding this comment

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

Umm right now I dont see the trust region docstring on the main docs: https://docs.sciml.ai/NonlinearSolve/stable/api/nonlinearsolve/ . I thought it is because the docstring is not at the beginning.

Copy link
Member Author

Choose a reason for hiding this comment

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

So should the Enum definition be on the main src/NonlinearSolve.jl file instead?

Copy link
Member

Choose a reason for hiding this comment

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

It's because the docstring wasn't right before the function. It has to be exactly the line before the function definition, no space.

Copy link
Member

Choose a reason for hiding this comment

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

It's already working on the dev version: https://docs.sciml.ai/NonlinearSolve/dev/api/nonlinearsolve/

@ChrisRackauckas ChrisRackauckas merged commit 7981d35 into SciML:master Jul 30, 2023
@yash2798 yash2798 deleted the ys/tr_doctsrings branch July 30, 2023 15:36
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.

3 participants