[GitHub] [airflow] potiuk commented on issue #14644: Hard-to-find documentation for a Docker image

[GitBox <gi...@apache.org>]

potiuk commented on issue #14644:
URL: https://github.com/apache/airflow/issues/14644#issuecomment-794503789


   I think many people are asking for docker image and have hard time finding it separate section (option b) is fine). However ☺️ think there is one caveat with the current airflow/providers/split which it will only reinforce. 
   
   Once you are in airflow documentation, it is not easily to realize that there are more components (providers and image when it is separated out. Most people will not go to the docs of airflow via url - they will reach it via Google search or history in the browser. Then - when you are already in airflow docs, there is no way of knowing that you should click on the airflow logo to get to the airflow + providers + image directory. And it is not very accessibility friendly. So while separating it out is fine, we should - i think also add some way for people. To know that provider/image documentation is there - other than clicking at the Airflow logo. Maybe a separate section in the table of content should be added ? Something that will clearly say hat You can reach out to full set of airflow- related docs this way? 
   
   Not sure about name though? Additional documentation? Beyond Airflow ? 


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