[GitHub] [airflow] TohnJhomas opened a new pull request, #27235: Restructure Docs

[GitBox]

TohnJhomas opened a new pull request, #27235:
URL: https://github.com/apache/airflow/pull/27235

   This PR is designed to restructure the overcrowded and confusing sidebar of 
the Astronomer Documentation. This is intended to allow for further scalability 
of the airflow docs, and to increase user-friendliness to new users. 
   
   The current docs have 28 top-level pages and two sub-sections of substance: 
"How-to Guides" and "Concepts."  Here I've attempted to clean up the sidebar 
and make the structure more clear by both splitting "Concepts" into three new 
top-level pages ("Core Concepts," "Authoring and Scheduling" and 
"Administration and Deployment") and folding many of the current top-level 
pages into these categories. 
   
   The structure of the docs as they currently are is visually here: The left 
column is representative of the top-level sidebar, with the concepts subsection 
broken out to the right. How-to guides is another large section, but because it 
didn't undergo any substantial change I've hidden the sub-pages for ease of 
understanding.
   
   <img width="770" alt="Screen Shot 2022-10-24 at 1 12 51 PM" 
src="https://user-images.githubusercontent.com/49878111/197607094-514b18bc-e073-49fe-99e6-3a391b782022.png";>
   
   
   The structure of the refactored docs is below, with the same format as 
above: 
   
   <img width="713" alt="Screen Shot 2022-10-24 at 1 12 41 PM" 
src="https://user-images.githubusercontent.com/49878111/197607202-5b1a2ac4-0c73-4160-9c6f-b852b6edc89c.png";>
   
   
    ---
   


-- 
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: commits-unsubscr...@airflow.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org