sunank200 commented on issue #49738: URL: https://github.com/apache/airflow/issues/49738#issuecomment-3932000225
Yes, restructuring the current airflow docs mentioned below is pending. > [@sunank200](https://github.com/sunank200) yes, I was talking about this! > > There is a lot of information in this section, and at a glance looks like has a lot of overlap with `Authoring and Scheduling`, and `Administration and Deployment`. We should probably look at all three holistically, and target content for tailored to the intended audience. In the Airflow Security Model, we talk about there being a Deployment Manager, DAG Author and Operations User, and we should probably stick to concepts that are relevant for the DAG Author and Operations Users here. > > For example, in core concepts, I don't think it makes sense to have "Auth Manager" there as most people won't interact with it: That's probably more suited to be in Administration and Deployment. Even architecture probably doesn't matter to the average user. Pools is in Administration and Deployment, but should probably be in Core Concepts since DAG Authors may have to interact with them. > > I haven't given as much thought as I should, so I think as a start it would be great if we did an audit of the content that's there in a spreadsheet, and grouped them into things that are thematically related. Then we can figure out what sections need to be updated. -- 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: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
