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

docs: fix silently failing c.i. build of the sphinx docs #459

Open
wants to merge 10 commits into
base: main
Choose a base branch
from

Conversation

CalMacCQ
Copy link
Contributor

@CalMacCQ CalMacCQ commented Feb 3, 2025

closes #458

The issue was twofold. Firstly the wheelhouse directory could not be found after the "cd" into the docs directory. secondly we were also not using "recursive" mode for the docs submodules in c.i.

Will add link checking in a follow up PR I think. Its proving to be a bit more annoying than I thought to get it working with the other stuff in build-docs.sh

I think we should maybe change a few things about how this works going forward.

@CalMacCQ CalMacCQ requested a review from cqc-melf as a code owner February 3, 2025 17:46
@CalMacCQ
Copy link
Contributor Author

CalMacCQ commented Feb 3, 2025

Here's the C.I. failure

Screenshot 2025-02-03 at 13 05 16

This didn't manifest before for two reasons.

  1. Sphinx warnings (such as pytket-qiskit not being installed) were allowed by the build. We can treat warninngs as errors with the -W flag in sphinx-build
  2. Even if warnings were treated as errors, the build-docs.sh script was missing +/-e exit flags so the errors would not fail the C.I. checks.

for w in `find wheelhouse/ -type f -name "*.whl"` ; do poetry run pip install $w ; done
bash ./docs/install.sh
cd docs
for w in `find ../wheelhouse/ -type f -name "*.whl"` ; do poetry run pip install $w ; done
Copy link
Contributor Author

@CalMacCQ CalMacCQ Feb 6, 2025

Choose a reason for hiding this comment

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

Seems the reason this wasn't working it that we couldn't find the wheelhouse directory after "cd"ing into docs

After 0773b8c the checks are passing.

@CalMacCQ CalMacCQ changed the title [DRAFT] fix docs C.I. build docs: fix silently failing c.i. build of the sphinx docs Feb 6, 2025
@CalMacCQ CalMacCQ requested review from cqc-melf and removed request for cqc-melf February 6, 2025 13:37
Copy link
Collaborator

@cqc-melf cqc-melf left a comment

Choose a reason for hiding this comment

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

What are the implications for the other extension repos? Should we update them as well?

rm -rf build/

# This build script is only used for local docs build.
Copy link
Collaborator

Choose a reason for hiding this comment

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

And on the CI for doc checks?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Good point, I'll clarify that.

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.

pytket-qiskit docs C.I. build failing silently
2 participants