Re: Where to put docs on configuring specific kinds of connections? (Or restructuring the docs the way Django does)

PR: https://github.com/apache/incubator-airflow/pull/3400 Jira: https://issues.apache.org/jira/browse/AIRFLOW-2509 On Tue, May 22, 2018 at 9:12 AM Tim Swast wrote: > I think the whole "Configuration" page could benefit from getting split > into separate how-to guides.

Re: Where to put docs on configuring specific kinds of connections? (Or restructuring the docs the way Django does)

I think the whole "Configuration" page could benefit from getting split into separate how-to guides. Basically, every sub-heading in Configuration becomes a different how-to guide. Since the configuration page is attempting to do double-duty as a tutorial right now, keep the current sequence, at

Re: Where to put docs on configuring specific kinds of connections? (Or restructuring the docs the way Django does)

Hi Tim, My personal opinion is to write the docs on GCP connection down at GCP Integration page would be an ideal fit but would like to hear others opinion as well. +1 for creating separate How-To guides.

Re: Where to put docs on configuring specific kinds of connections? (Or restructuring the docs the way Django does)

Hey Tim - I came to Airflow from the Django world as well and had the same thought that much of the work that's been put into their docs over time could be applied here too. In terms of documentation for large Python projects, perhaps they're the gold standard. Can you give a few examples of

Where to put docs on configuring specific kinds of connections? (Or restructuring the docs the way Django does)

Hey folks, I'd like to write some docs on how to create a GCP connection (and leave room for documenting other kinds of connections as well). Currently it seems like there are a couple places such a thing could fit: - https://airflow.incubator.apache.org/configuration.html#connections -