)]}'
{"doc/source/install/index.rst":[{"author":{"_account_id":28006,"name":"teim-ci","display_name":"teim-ci","email":"ci@seanmooney.info","username":"ci-sean-mooney","status":"this is a third-party ci account run by sean-k-mooney on irc\nhosted at zuul.teim.app"},"tag":"autogenerated:zuul:automatic-ci","change_message_id":"6e88d12c09276399fa03e70a17465a8c6645bc25","unresolved":false,"context_lines":[{"line_number":43,"context_line":"* A message broker (RabbitMQ recommended)."},{"line_number":44,"context_line":"* Python 3.10 or newer."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"See the :doc:`/admin/support-matrix` for supported VM operations and driver"},{"line_number":47,"context_line":"compatibility with specific Nova versions."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"Installation Methods"}],"source_content_type":"text/x-rst","patch_set":1,"id":"94bbb7fc_51a362b7","line":46,"updated":"2026-08-21 09:56:49.000000000","message":"The rewritten index references :doc:`/admin/support-matrix` in the Prerequisites section and again in Related Documentation, but that document does not exist. The support matrix lives at doc/source/reference/support-matrix.rst and is referenced elsewhere in the tree as :doc:`reference/support-matrix`. Each missing :doc: target makes Sphinx emit a cross-reference warning, and the project builds docs with \u0027sphinx-build -W --keep-going\u0027, so the build exits non-zero.\n\n**Severity**: CRITICAL | **Confidence**: 0.9\n\n**Impact**: The documentation build job fails with warnings treated as errors, blocking CI for this patch and anything stacked on it. Even without -W, the rendered HTML would show plain text instead of links for both mentions.\n\n**Priority**: Immediate\n**Recommendation**:\nPoint both references at the real location, e.g. \u0027:doc:`/reference/support-matrix`\u0027, on lines 46 and 108.","commit_id":"e7f2a631224e3758eb27e4dfbbec2396bbb1b38c"},{"author":{"_account_id":28006,"name":"teim-ci","display_name":"teim-ci","email":"ci@seanmooney.info","username":"ci-sean-mooney","status":"this is a third-party ci account run by sean-k-mooney on irc\nhosted at zuul.teim.app"},"tag":"autogenerated:zuul:automatic-ci","change_message_id":"6e88d12c09276399fa03e70a17465a8c6645bc25","unresolved":false,"context_lines":[{"line_number":49,"context_line":"Installation Methods"},{"line_number":50,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":".. toctree::"},{"line_number":53,"context_line":"   :maxdepth: 1"},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"   install-from-source"}],"source_content_type":"text/x-rst","patch_set":1,"id":"2b31814a_ea3e539d","line":52,"updated":"2026-08-21 09:56:49.000000000","message":"The new toctree lists only install-from-source and install-from-pip; the previous \u0027common\u0027 entry was dropped. install/common.rst is consumed elsewhere only via \u0027.. include:: common.rst\u0027 in install-from-source.rst and install-from-pip.rst, and include:: does not satisfy Sphinx\u0027s toctree requirement. Sphinx therefore emits the default \u0027document isn\u0027t included in any toctree\u0027 warning for install/common.rst, which is fatal under the project\u0027s sphinx-build -W configuration. Before this change the document was in the toctree and the build was clean.\n\n**Severity**: CRITICAL | **Confidence**: 0.85\n\n**Impact**: The docs build job fails on the orphaned-document warning under warnings-as-errors, blocking CI. Additionally, the change\u0027s own prose (\u0027Both methods share common configuration steps documented in :doc:`common`\u0027) links to a page that would no longer appear in navigation.\n\n**Priority**: Immediate\n**Recommendation**:\nEither keep \u0027common\u0027 in the toctree (e.g., as a \u0027Common Configuration\u0027 entry under Installation Methods, which also matches the :doc:`common` links at lines 58 and 66), or add \u0027:orphan:\u0027 near the top of install/common.rst if the page is intentionally an include-only/link-only target.","commit_id":"e7f2a631224e3758eb27e4dfbbec2396bbb1b38c"},{"author":{"_account_id":28006,"name":"teim-ci","display_name":"teim-ci","email":"ci@seanmooney.info","username":"ci-sean-mooney","status":"this is a third-party ci account run by sean-k-mooney on irc\nhosted at zuul.teim.app"},"tag":"autogenerated:zuul:automatic-ci","change_message_id":"7279d018700bc32031df71ed479e9bb20128b3f7","unresolved":false,"context_lines":[{"line_number":49,"context_line":"Installation Methods"},{"line_number":50,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":".. toctree::"},{"line_number":53,"context_line":"   :maxdepth: 1"},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"   install-from-source"}],"source_content_type":"text/x-rst","patch_set":2,"id":"4db218a9_07013c79","line":52,"updated":"2026-08-21 11:15:47.000000000","message":"The rewrite drops the \u0027common\u0027 entry from the install toctree (now only install-from-source and install-from-pip) but still links to it twice via :doc:`common` in the body text. Sphinx only suppresses the \u0027document isn\u0027t included in any toctree\u0027 warning for documents listed in a toctree or explicitly marked with the :orphan: option; a :doc: cross-reference does not satisfy toctree inclusion. doc/source/install/common.rst has no :orphan: marker and is not referenced from any other toctree in the tree, so the docs build will emit a warning for it, and the project\u0027s docs environment runs \u0027sphinx-build -W --keep-going\u0027 (tox.ini line 87), which promotes that warning to an error and fails the build.\n\n**Severity**: HIGH | **Confidence**: 0.85\n\n**Impact**: The documentation build job (\u0027tox -e docs\u0027 and the corresponding CI docs jobs) will fail with \u0027WARNING: document isn\u0027t included in any toctree\u0027 promoted to an error by -W, blocking merge of this docs-only change. Additionally, even if warnings were tolerated, the rendered \u0027Common Configuration\u0027 page would lose sidebar navigation placement.\n\n**Priority**: Before merge\n**Recommendation**:\nEither keep \u0027common\u0027 in the toctree (e.g. listed after install-from-pip so it renders in sequence with the shared configuration steps), or add \u0027:orphan:\u0027 at the top of doc/source/install/common.rst since it is now intentionally referenced only via inline :doc: links. The :orphan: approach matches the new page design of referencing it from body text.","commit_id":"7fd1d3da7d27542e3249a8ff568ef4ffe0618640"}]}