search

astronomer / dag-factory

Dynamically generate Apache Airflow DAGs from YAML configuration files
Apache License 2.0
1.21k stars 182 forks source link

Host user-facing DAG Factory docs #279

Open tatiana opened 3 weeks ago

tatiana commented 3 weeks ago

To be aligned with @cmarteepants and the docs team where we want to host the DAG Factory docs:

  1. ReadTheDocs
  2. Astro website
  3. GitHub pages
pankajkoti commented 3 weeks ago

Since this is also related to #278 , and @pankajastro you might be aligning with @cmarteepants & the docs team on this one too, I am assigning this issue to you too. Please feel to re-assign/un-assign it later when we would actually take care of the implementation for this based on our Sprint planning.

cmarteepants commented 3 weeks ago

This is timely! Astro docs are moving away from netlify, so doesn't make sense to host on Astro until that's done. Whatever we use has to be markdown-compatible for an easy lift to the new framework, which excludes Sphinx/ReadTheDocs since that uses .rst.

Their recommendation is to use Github Pages (and markdown!)