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

DOC: update OptimizeResult notes #14693

Merged
merged 2 commits into from Sep 5, 2021
Merged

Conversation

FirefoxMetzger
Copy link
Contributor

Closes: #14683

Does two things:

  • Address the problem of Notes being placed before Attributes
  • Edit the spelling in the first sentence.

Closes: scipy#14683

Does two things:
- Address the problem of `Notes` being placed before `Attributes`
- Edit the spelling in the first sentence.
Copy link
Contributor

@mdhaber mdhaber left a comment

Choose a reason for hiding this comment

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

OptimizeResult at least needs to be in single backticks. Not sure what should be done with keys but I think this will link to the documentation.

scipy/optimize/optimize.py Outdated Show resolved Hide resolved
scipy/optimize/optimize.py Outdated Show resolved Hide resolved
[skip azp] [skip actions]
Copy link
Contributor Author

@FirefoxMetzger FirefoxMetzger left a comment

Choose a reason for hiding this comment

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

@mdhaber It's sphinx, so we will have to use rst instead of markdown here I believe.

Edit: ... or not? This is a bit surprising, but also pretty cool. I'll have to take a closer look at what scipy does to render API docs.

scipy/optimize/optimize.py Show resolved Hide resolved
scipy/optimize/optimize.py Show resolved Hide resolved
@mdhaber
Copy link
Contributor

mdhaber commented Sep 4, 2021

It seems to be rendering as I intended. Look good to you?

@FirefoxMetzger
Copy link
Contributor Author

@mdhaber Yes. Looks perfect to me; sorry for the noise. I was under the impression that rst and markdown behave differently here. Clearly, I am wrong and there is some feature/behavior that I am not aware of :)

@mdhaber
Copy link
Contributor

mdhaber commented Sep 5, 2021

Thanks @FirefoxMetzger!

@mdhaber mdhaber merged commit ff34402 into scipy:master Sep 5, 2021
@FirefoxMetzger FirefoxMetzger deleted the patch-1 branch September 5, 2021 05:11
@tylerjereddy tylerjereddy added this to the 1.8.0 milestone Sep 12, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

DOC: OptimizeResult Notes are placed before attribute section, but refers to them as if placed after
3 participants