[GitHub] [airflow] potiuk commented on issue #6213: [AIRFLOW-XXX] Extract operators and hooks to separate page

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

potiuk commented on issue #6213: [AIRFLOW-XXX] Extract operators and hooks to separate page
URL: https://github.com/apache/airflow/pull/6213#issuecomment-536556186
 
 
   I agree with @mik-laj, Integration.rst was really  "a bag of everything" (see it [here](https://airflow.readthedocs.io/en/latest/integration.html)).
   
   With those changes where we restructure it and separate out types of integration, it is much easier to navigate with the changes above. And we are not removing any information - quite contrary we are adding a lot of "overview" information by having all the tables and splitting integration.rst in a more meaningful way.
   
   @feluelle -> are you afraid that people are used to the old structure of documentation or just linked to the old documentation with URL links ? 
   
   If it's the first, I think it's really well known in the community that we are working on improving documentation so they won't be surprised.
   
   @mik-laj - maybe we can involve the community a bit more and ask them what they think (after the merge - it will be easier via "readthedocs") ? 
   
   I think AIP is a bit overkill for this. However we could just explain community a bit more context - why we are doing it and let and let them see it before we "release it", that would be really nice and  give the community a chance to comment and influence it.

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


With regards,
Apache Git Services