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 2021/01/16 13:32:46 UTC

[GitHub] [airflow] potiuk opened a new issue #13716: Selective documentation build 

potiuk opened a new issue #13716:
URL: https://github.com/apache/airflow/issues/13716


   Followinq #13706 . 
   
   Building docs only is not as optimized as it can be. 
   I think it needs to have some separate behaviour not only optimising the other builds 
   In case of the doc build we should not only optimise non-needed jobs, but also optimise which part of the documentation should be built.
   
   In case of the https://github.com/apache/airflow/pull/13696/files 
   
   ```
   docs/apache-airflow/howto/index.rst
   docs/apache-airflow/howto/initialize-database.rst
   docs/apache-airflow/howto/set-up-database.rst
   docs/apache-airflow/installation.rst
   docs/apache-airflow/redirects.txt
   ```
   
   Only 'apache-airflow' docs should be built. 
   
   Similarly when there are limited changes to provider packages (both doc and code).
   If we see that we have change in docs/code for only some of the providers, we can take a look at this dependencies:
   https://github.com/apache/airflow/blob/master/airflow/providers/dependencies.json
   
   And only build documentation for those Providers that changed and their dependencies.  And we should do airflow documentation build only when any of the airflow documentation or code changed. 
   
   It should be rather easy to take a look at the list of files and produce such changes.
   
   <!--
   
   Welcome to Apache Airflow!  For a smooth issue process, try to answer the following questions.
   Don't worry if they're not all applicable; just try to include what you can :-)
   
   If you need to include code snippets or logs, please put them in fenced code
   blocks.  If they're super-long, please use the details tag like
   <details><summary>super-long log</summary> lots of stuff </details>
   
   Please delete these comment blocks before submitting the issue.
   
   -->
   
   **Description**
   
   <!-- A short description of your feature -->
   
   **Use case / motivation**
   
   <!-- What do you want to happen?
   
   Rather than telling us how you might implement this solution, try to take a
   step back and describe what you are trying to achieve.
   
   -->
   
   **Are you willing to submit a PR?**
   
   <!--- We accept contributions! -->
   
   **Related Issues**
   
   <!-- Is there currently another issue associated with this? -->
   


----------------------------------------------------------------
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] potiuk closed issue #13716: Selective documentation build

Posted by GitBox <gi...@apache.org>.
potiuk closed issue #13716:
URL: https://github.com/apache/airflow/issues/13716


   


----------------------------------------------------------------
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] potiuk commented on issue #13716: Selective documentation build

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


   cc: @mik-laj 


----------------------------------------------------------------
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] kaxil commented on issue #13716: Selective documentation build

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


   I would say let's not try to optimize this because we use cross reference of apache-airflow in some providers and vice-versa to we should build all the docs.
   
   https://github.com/apache/airflow/issues/13706 should be enough


----------------------------------------------------------------
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 #13716: Selective documentation build

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


   Is it related? https://github.com/apache/airflow/issues/12983


----------------------------------------------------------------
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] potiuk commented on issue #13716: Selective documentation build

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


   Closing as duplicate of #12983


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