)]}'
{"/COMMIT_MSG":[{"author":{"_account_id":9976,"name":"Ronelle Landy","email":"rlandy@redhat.com","username":"rlandy"},"change_message_id":"fcaa99f5dc14eab2705888b9266fe9cc0e6abef2","unresolved":true,"context_lines":[{"line_number":25,"context_line":"detailed guidance that belongs in human-readable contributor docs."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"These documents are adapted from the conventions established in Nova\u0027s"},{"line_number":28,"context_line":"agentic coding documentation."},{"line_number":29,"context_line":""},{"line_number":30,"context_line":"Assisted-by: Claude Sonnet 4.5"},{"line_number":31,"context_line":"Change-Id: Ie39407c1bf250ecb90333f12dbe58341f39a5200"}],"source_content_type":"text/x-gerrit-commit-message","patch_set":5,"id":"5738e4af_0e40d014","line":28,"updated":"2026-08-24 06:11:48.000000000","message":"Would reference https://review.opendev.org/c/openstack/agentic-workflows/+/1001811/ if merged prior to documentation review","commit_id":"e6a059b2f7d9019afadfc12022c7f41a07f5ec28"}],"doc/source/contributor/driver-development-guide.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":"59c493627f778f769cb46b655c5b9372bab1d461","unresolved":false,"context_lines":[{"line_number":14,"context_line":"programming or binding."},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"See :doc:`/contributor/repo-overview` for repository structure and"},{"line_number":17,"context_line":":doc:`/admin/support-matrix` for the current driver support status."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"Before You Start"},{"line_number":20,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":2,"id":"80786d5b_d13d9a66","line":17,"updated":"2026-08-21 07:56:39.000000000","message":"The rewritten driver development guide references the driver support matrix as :doc:`/admin/support-matrix` in two places (the Overview section and step 7 of the manual process). No document exists at doc/source/admin/support-matrix.rst; the actual support matrix is doc/source/reference/support-matrix.rst, as referenced by doc/source/index.rst (\u0027:doc:`reference/support-matrix`\u0027) and doc/source/contributor/releasenotes.rst (\u0027:doc:`DriversSupportMatrix \u003c/reference/support-matrix\u003e`\u0027). Sphinx emits an \u0027unknown document\u0027 warning for these references, and the project\u0027s docs environment runs \u0027sphinx-build -W --keep-going\u0027 (tox.ini lines 87/95), which turns warnings into errors, so the openstack-tox-docs job will fail on this patch.\n\n**Severity**: HIGH | **Confidence**: 0.95\n\n**Impact**: The documentation build job fails (warnings-as-errors), blocking merge until fixed; even if warnings were ignored, readers following the link would get a dead reference.\n\n**Priority**: Before merge\n**Recommendation**:\nChange both occurrences of :doc:`/admin/support-matrix` to :doc:`/reference/support-matrix` in doc/source/contributor/driver-development-guide.rst (lines 17 and 110), matching how doc/source/index.rst and releasenotes.rst reference the support matrix.","commit_id":"0eb71861e3b5ac049fd91d1eb3c6fba337d69988"},{"author":{"_account_id":9976,"name":"Ronelle Landy","email":"rlandy@redhat.com","username":"rlandy"},"change_message_id":"9683a029c3cac648f8cb4e779b6dbfe046b814dd","unresolved":true,"context_lines":[{"line_number":14,"context_line":"programming or binding."},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"See :doc:`/contributor/repo-overview` for repository structure and"},{"line_number":17,"context_line":":doc:`/admin/support-matrix` for the current driver support status."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"Before You Start"},{"line_number":20,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":2,"id":"41876097_5510166d","line":17,"in_reply_to":"80786d5b_d13d9a66","updated":"2026-08-21 07:59:17.000000000","message":"This references the changes in https://review.opendev.org/c/openstack/cyborg/+/1001755","commit_id":"0eb71861e3b5ac049fd91d1eb3c6fba337d69988"},{"author":{"_account_id":9976,"name":"Ronelle Landy","email":"rlandy@redhat.com","username":"rlandy"},"change_message_id":"51be26ffd2f359266fbe4f2260b65834c864084a","unresolved":true,"context_lines":[{"line_number":43,"context_line":".. note::"},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"   **For AI coding assistants:** Future commits will add skill definitions"},{"line_number":46,"context_line":"   that automate common driver development tasks. These skills will:"},{"line_number":47,"context_line":""},{"line_number":48,"context_line":"   * Scaffold a new driver from templates with proper entry points"},{"line_number":49,"context_line":"   * Generate discover() methods based on device enumeration strategy"}],"source_content_type":"text/x-rst","patch_set":5,"id":"a051c116_f4f83e0a","line":46,"updated":"2026-08-24 06:09:13.000000000","message":"https://review.opendev.org/c/openstack/agentic-workflows/+/1001812/ is a kernel development skill but could relate to the driver development. Note references to pci-sim.  If the skill is merge prior to the documentation review, we should point to this skill.","commit_id":"e6a059b2f7d9019afadfc12022c7f41a07f5ec28"}],"doc/source/contributor/repo-overview.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":"417aeca791433f1bd6528d3d06aae761d77ee843","unresolved":false,"context_lines":[{"line_number":60,"context_line":"    Operator guides: deployment, configuration, driver support matrix."},{"line_number":61,"context_line":"``doc/source/contributor/``"},{"line_number":62,"context_line":"    Developer guides: process, testing, driver development, agentic coding."},{"line_number":63,"context_line":"``doc/source/reference/``"},{"line_number":64,"context_line":"    Internal reference: REST API microversion history."},{"line_number":65,"context_line":"``doc/source/user/``"},{"line_number":66,"context_line":"    End-user guides: using Cyborg with device profiles and ARQs."}],"source_content_type":"text/x-rst","patch_set":5,"id":"4d88d4ba_6126285b","line":63,"updated":"2026-08-21 11:07:32.000000000","message":"The new repository overview lists doc/source/reference/ as \u0027Internal reference: REST API microversion history\u0027, but that directory does not exist at the review head. It contained support-matrix.rst and driver-table.rst and was removed by the parent commit 8f6081a (\u0027Move support matrix to admin docs\u0027), which moved support-matrix.rst to doc/source/admin/. The REST API version history actually lives at doc/source/contributor/rest_api_version_history.rst. The same \u0027doc/ Structure\u0027 section also places releasenotes/ (a repository-root directory) under a heading that describes doc/ contents.\n\n**Severity**: WARNING | **Confidence**: 0.97\n\n**Impact**: The document\u0027s sole purpose is contributor/AI-agent orientation, so a mapping to a nonexistent directory sends new contributors (and agents routed to this file) looking for API microversion history in the wrong place; the apparent staleness relative to the parent commit also erodes trust in the rest of the map.\n\n**Suggestion**:\nRemove the doc/source/reference/ entry (or replace it with the real location, e.g. note that REST API version history lives at doc/source/contributor/rest_api_version_history.rst), and either move releasenotes/ to the \u0027Root Files\u0027 list or rename the section so root-level directories are not presented as doc/ contents.","commit_id":"e6a059b2f7d9019afadfc12022c7f41a07f5ec28"}]}