potiuk edited a comment on issue #14231: URL: https://github.com/apache/airflow/issues/14231#issuecomment-779473067
> I also recommend these two articles that explain the differences between a user manual and a quick start guide. > https://medium.com/@shavindridissanayake/are-quick-start-guides-important-cee3b2758ae8 > https://medium.com/make-it-clear/the-importance-of-quick-start-guides-26ab7b1cf0df Why don't we turn the "installation" into a "quick start guide" ? I really think both INSTALL and installation.html are exactly the type of document which is described by the links you sent. And they are rather close to this ideal. They might need some improvments, but claiming that we need "new" documents there is I think not justified. We need to improve what is there already . We have lot more "user manual" documents, but those two which we have are serving the purpose. I would rather focus on improving those rather than multiply the number of documents we have. ---------------------------------------------------------------- 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: [email protected]
