Skip to content

fix(docs): pass libdoc_markdown as 1 so Sphinx 9 accepts the override - #1374

Merged
mikahanninen merged 1 commit into
masterfrom
fix/docs-sphinx9-markdown-flag
Nov 1, 2026
Merged

mikahanninen merged 1 commit into
masterfrom
fix/docs-sphinx9-markdown-flag

Conversation

@mikahanninen

Copy link
Copy Markdown
Collaborator

Summary

The docs workflow has failed on every master push since #1367 (five runs). The root lock moved
to Sphinx 9, which validates -D overrides of boolean config values and only accepts 0 or 1:

sphinx.errors.ConfigError: 'libdoc_markdown' must be '0' or '1', got 'True'
  • invocations/docs.py: the markdown build passes -D libdoc_markdown=1 instead of =True.
  • .github/workflows/docs.yaml: trigger on uv.lock instead of the long-removed poetry.lock,
    so lock-file changes rebuild the docs again.

Merge before the rpaframework 34.0.0 PR (#1373): that one changes the root pyproject.toml,
which triggers this workflow, and the GitHub Pages site has not been republished since 31 Oct.

Test plan

  • Locally with Sphinx 9.1.0 from the root venv: -D libdoc_markdown=True reproduces the
    configuration error, -D libdoc_markdown=1 starts the markdown build
  • docs workflow green on the merge to master

🤖 Generated with Claude Code

https://claude.ai/code/session_01D3gagC7dAijWH8bZhfx9Ss

Sphinx 9 validates -D overrides of boolean config values and only
accepts 0 or 1; since the root lock moved to Sphinx 9 (#1367) the docs
workflow failed on every master push with
"'libdoc_markdown' must be '0' or '1', got 'True'".
Also trigger the docs workflow on uv.lock instead of the removed
poetry.lock.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01D3gagC7dAijWH8bZhfx9Ss
@github-actions

github-actions Bot commented Nov 1, 2026

Copy link
Copy Markdown

Wheel artifact

Built from commit cfc8d8a — download from the workflow run (Artifacts section at the bottom of the page).

Artifact name: rpaframework-wheel (retained 14 days)

@mikahanninen
mikahanninen merged commit b112ecb into master Nov 1, 2026
70 checks passed
@mikahanninen
mikahanninen deleted the fix/docs-sphinx9-markdown-flag branch November 1, 2026 15:34
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.

1 participant