I recently went through the airflow docs for the first time - agree. But this comment thread has much more helpful than any of the docs!