casaroli opened a new pull request, #21933:
URL: https://github.com/apache/nuttx/pull/21933

   ## Summary
   
   The documentation build fails on master since #21578: 
`Documentation/ReleaseNotes/NuttX-13.1.1.md:document isn't included in any 
toctree` (Sphinx treats warnings as errors), so `build-html` is red on every PR.
   
   #21578 also deleted the 13.1.0 release notes: its commit "Documentation: 
rename NuttX-13.1.0.md file" (f889bcf26d0) removed `NuttX-13.1.0` and added no 
`NuttX-13.1.0.md`.
   
   - Commit 1 reverts f889bcf26d0, so `NuttX-13.1.0` is back.
   - Commit 2 renames it to `NuttX-13.1.0.md` and underlines its title with `=` 
(one top-level heading per release, as the note in `index.rst` asks).
   - Commit 3 adds `NuttX-13.1.1` and `NuttX-13.1.0` at the top of the toctree 
in `Documentation/ReleaseNotes/index.rst`.
   
   The text of both release notes does not change.
   
   ## Impact
   
   Documentation only. `build-html` passes again, and the release notes index 
lists 13.1.1 and 13.1.0.
   
   ## Testing
   
   `pipenv sync` and `pipenv run make html` in `Documentation/`, as the 
documentation workflow does (Python 3.10, plantuml from apt): "build 
succeeded", and `_build/html/ReleaseNotes/` has `NuttX-13.1.0.html` and 
`NuttX-13.1.1.html`. On master the same build stops at the toctree warning 
above.
   
   `tools/checkpatch.sh -c -u -m -g` passes.
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to