You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@trafficserver.apache.org by GitBox <gi...@apache.org> on 2021/06/23 16:41:45 UTC

[GitHub] [trafficserver] bneradt opened a new issue #7983: Update the version of Sphinx in our CI machines

bneradt opened a new issue #7983:
URL: https://github.com/apache/trafficserver/issues/7983


   Currently, the CI builds our ATS Sphinx docs with Sphinx version 2.0.1. This can be seen from this job:
   https://ci.trafficserver.apache.org/view/10.x%20master/job/docs-master/
   
   ```
   Making html in uml
   ...
   Running Sphinx v2.0.1
   ...
   ```
   
   Currently the latest version is 4.0.2. We are currently pinned to the 3.x releases however due to the issue described in https://github.com/apache/trafficserver/issues/7941. 
   
   Thus, currently, developers will build their docs with Sphinx 3.x, and then CI will run in v2.0.1. This difference can cause unexpected Sphinx compilation issues. We should update CI.
   
   Before we do this, however, we should be sure that the docs will build for our supported 8.x, 9.x, and master branches using the later Sphinx version.
   


-- 
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.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [trafficserver] bneradt commented on issue #7983: Update the version of Sphinx in our CI machines

Posted by GitBox <gi...@apache.org>.
bneradt commented on issue #7983:
URL: https://github.com/apache/trafficserver/issues/7983#issuecomment-1074533570


   This should be fixed now with the new CI.


-- 
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: issues-unsubscribe@trafficserver.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [trafficserver] bneradt commented on issue #7983: Update the version of Sphinx in our CI machines

Posted by GitBox <gi...@apache.org>.
bneradt commented on issue #7983:
URL: https://github.com/apache/trafficserver/issues/7983#issuecomment-867128721


   Before we can update CI, we need to update our 8.1.x and 7.1.x branches for Sphinx 3.x. Currently building docs on those branches with Sphinx 3.x fails due to a small variety of issues. These PRs unblock this issue:
   
   - https://github.com/apache/trafficserver/pull/7984
   - https://github.com/apache/trafficserver/pull/7985
   


-- 
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.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [trafficserver] bneradt closed issue #7983: Update the version of Sphinx in our CI machines

Posted by GitBox <gi...@apache.org>.
bneradt closed issue #7983:
URL: https://github.com/apache/trafficserver/issues/7983


   


-- 
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: issues-unsubscribe@trafficserver.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [trafficserver] bneradt commented on issue #7983: Update the version of Sphinx in our CI machines

Posted by GitBox <gi...@apache.org>.
bneradt commented on issue #7983:
URL: https://github.com/apache/trafficserver/issues/7983#issuecomment-867148242


   Resolving this issue (i.e., updating CI to have Sphinx 3.x installed) unblocks #7978 


-- 
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.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [trafficserver] bneradt commented on issue #7983: Update the version of Sphinx in our CI machines

Posted by GitBox <gi...@apache.org>.
bneradt commented on issue #7983:
URL: https://github.com/apache/trafficserver/issues/7983#issuecomment-867146471


   In addition to the above, I noticed 9.0.x needs a couple updates as well for Sphinx 3.x: 
   
   - https://github.com/apache/trafficserver/pull/7987


-- 
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.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org