You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@airflow.apache.org by GitBox <gi...@apache.org> on 2020/05/15 06:21:38 UTC

[GitHub] [airflow] mik-laj opened a new issue #8874: Documentation building is slow.

mik-laj opened a new issue #8874:
URL: https://github.com/apache/airflow/issues/8874


   Hello, 
   
   Building documentation takes over 10 minutes when only a small change has been made. I think it is worth analyzing whether this process cannot be speed-uo.
   My propositions:
   
   - incremental rebuilds:  Currently, building is always started from scratch, but Sphinx supports building only changed files
      https://github.com/apache/airflow/blob/master/docs/build#L51
      https://www.sphinx-doc.org/en/master/man/sphinx-build.html#cmdoption-sphinx-build-E
   - multiprocessing buidl: Sphinx support distributing the build over N processes in parallel, to make building on multiprocessor machines more effective. This may require changes(or mock patch) to external plugins.
      https://www.sphinx-doc.org/en/master/man/sphinx-build.html#cmdoption-sphinx-build-E
   
   Best regards,
   Kamil


----------------------------------------------------------------
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] [airflow] mik-laj closed issue #8874: Documentation building is slow

Posted by GitBox <gi...@apache.org>.
mik-laj closed issue #8874:
URL: https://github.com/apache/airflow/issues/8874


   


----------------------------------------------------------------
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] [airflow] mik-laj commented on issue #8874: Documentation building is slow

Posted by GitBox <gi...@apache.org>.
mik-laj commented on issue #8874:
URL: https://github.com/apache/airflow/issues/8874#issuecomment-742465772


   We divided the documentation into smaller packages. Now building documentation for apache-airflow takes less than 2 minutes and for apache-airflow-providers-telegram even less than 20 seconds.
   Closed by: https://github.com/apache/airflow/issues/11423


----------------------------------------------------------------
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] [airflow] ashb commented on issue #8874: Documentation building is slow

Posted by GitBox <gi...@apache.org>.
ashb commented on issue #8874:
URL: https://github.com/apache/airflow/issues/8874#issuecomment-629137622


   https://github.com/readthedocs/sphinx-autoapi/issues/191 if/when it comes would help too


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