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

Fix metadata detection of modules for historical Qiskit docs #821

Merged
merged 19 commits into from
Feb 15, 2024

Conversation

Eric-Arellano
Copy link
Collaborator

@Eric-Arellano Eric-Arellano commented Feb 15, 2024

Part of #66. We were failing to detect modules using old versions of Sphinx that set the module metadata in <div> rather than <span> or <section>.

Some of the module pages had no metadata at all, whereas some were misclassified as functions corresponding to the first function in the module's page. Fixing this metadata will fix the HTML meta properties, and it also fixes the table of contents to have correct nesting.

@Eric-Arellano
Copy link
Collaborator Author

I recommend viewing by commit. The first commit is the only manual one. I will spend the time this afternoon to closely review each commit - so feel free to do more of a spot check.

Copy link
Collaborator

@arnaucasau arnaucasau left a comment

Choose a reason for hiding this comment

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

Checked around 40% of the files and looks good to me! Thanks Eric!

@Eric-Arellano Eric-Arellano merged commit 5b1d272 into main Feb 15, 2024
5 of 6 checks passed
@Eric-Arellano Eric-Arellano deleted the EA/fix-metadata branch February 15, 2024 19:03
frankharkins pushed a commit to frankharkins/documentation that referenced this pull request Jul 22, 2024
)

Part of Qiskit#66. We were
failing to detect modules using old versions of Sphinx that set the
module metadata in `<div>` rather than `<span>` or `<section>`.

Some of the module pages had no metadata at all, whereas some were
misclassified as `functions` corresponding to the first function in the
module's page. Fixing this metadata will fix the HTML meta properties,
and it also fixes the table of contents to have correct nesting.
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.

2 participants