• 
      

    Fix some inconsistent build issues and legacy configuration for docs.

    Review Request #13116 — Created June 20, 2023 and submitted

    Information

    Review Board
    release-5.0.x

    Reviewers

    Every so often, we have some sporadic build issues that don't appear to
    make much sense. Mostly it seems to be logging-related, with logged
    output causing some blocked I/O issues. A possible culprit is the way we
    initialize Review Board in our Sphinx extension.

    This change updates that initialization to turn off logging, extensions,
    and template management, with a hope that this will avoid any issues
    that may be impacting Sphinx.

    Doc-related URL settings now use https instead of http in places,
    and some legacy imports have been removed.

    Along with that, the release notes now include the manual's extension
    for specialized references, so that the release notes can refer to
    relevant sections in the manual.

    Successfully built the manual and release notes.

    Tested the references with the in-progress changes for 5.0.5 release
    notes.

    Summary ID
    Fix some inconsistent build issues and legacy configuration for docs.
    Every so often, we have some sporadic build issues that don't appear to make much sense. Mostly it seems to be logging-related, with logged output causing some blocked I/O issues. A possible culprit is the way we initialize Review Board in our Sphinx extension. This change updates that initialization to turn off logging, extensions, and template management, with a hope that this will avoid any issues that may be impacting Sphinx. Doc-related URL settings now use `https` instead of `http` in places, and some legacy imports have been removed. Along with that, the release notes now include the manual's extension for specialized references, so that the release notes can refer to relevant sections in the manual.
    3542524843037f10ae1493bfffe2ac7539994f61
    david
    1. Ship It!
    2. 
        
    chipx86
    Review request changed
    Status:
    Completed
    Change Summary:
    Pushed to release-5.0.x (4e6810e)