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

API generation script: fix attributes headings #1153

Merged
merged 21 commits into from
Apr 10, 2024

Conversation

arnaucasau
Copy link
Collaborator

@arnaucasau arnaucasau commented Apr 10, 2024

Closes #1120

This PR changes the script to use the name extracted from the signature of the attributes instead of using the id to create the <h3>s. This behavior was changed in #1026, but It broke a couple of headings.

It also fixes two attributes of qiskit.algorithms.eigensolvers.VQD manually modifying the artifacts stored in Box for versions 0.39, 0.40, 0.41, 0.42, 0.43, 0.44, 0.45 and 0.46. See more at #1120

@qiskit-bot
Copy link
Contributor

Thanks for contributing to Qiskit documentation!

Before your PR can be merged, it will first need to pass continuous integration tests and be reviewed. Sometimes the review process can be slow, so please be patient. Thanks! 🙌

Copy link
Member

@frankharkins frankharkins left a comment

Choose a reason for hiding this comment

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

Thanks! This is a net improvement but I noticed a couple of quirks

Copy link
Member

@frankharkins frankharkins left a comment

Choose a reason for hiding this comment

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

Nice work, thanks!

Copy link
Collaborator

@Eric-Arellano Eric-Arellano left a comment

Choose a reason for hiding this comment

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

Thanks! Can you please clarify in the PR that you regenerated the HTML to fix the bad attribute? This PR is a mix of using the new HTML + your new code change

@@ -172,7 +172,7 @@ These functions will raise a custom subclass of [`QiskitError`](exceptions#qiski
Set the error message.
</Class>

### QPY\_VERSION
### qiskit.qpy.QPY\_VERSION
Copy link
Collaborator

Choose a reason for hiding this comment

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

Do you know what these were before the docs redesign? I'm not certain it makes sense to use the full path here because it makes the header longer. I'm surprised the name is the full path and not only QPY_VERSION. It's not necessarily bad, I'm only curious why name was set to that

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Yes, they had the long name as well. Here is the file before the docs redesign. I can investigate more about why it was set that way if you want :)

@arnaucasau arnaucasau added this pull request to the merge queue Apr 10, 2024
Merged via the queue into Qiskit:main with commit a8c7387 Apr 10, 2024
5 checks passed
@arnaucasau arnaucasau deleted the AC/fix-attributes-header branch April 10, 2024 16:56
frankharkins pushed a commit to frankharkins/documentation that referenced this pull request Jul 22, 2024
Closes Qiskit#1120 

This PR changes the script to use the `name` extracted from the
`signature` of the attributes instead of using the `id` to create the
`<h3>`s. This behavior was changed in Qiskit#1026, but It broke a couple of
headings.

It also fixes two attributes of `qiskit.algorithms.eigensolvers.VQD`
manually modifying the artifacts stored in
[Box](https://ibm.ent.box.com/folder/246867452622?s=tqmvw6ldivzkhh934nhufan4rg3dregr)
for versions 0.39, 0.40, 0.41, 0.42, 0.43, 0.44, 0.45 and 0.46. See more
at Qiskit#1120
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

Bad attribute in qiskit.algorithms.eigensolvers.VQD
4 participants