◾️はじめに

Airflow UI で インターフェイスをカスタマイズできるみたいで
それが、doc_mdってのを知ったのでメモ

【１】doc_md

* タスク インスタンスの詳細ビューに
　Markdown形式で説明文などを表示できる
 => 以下のサイトに画面キャプチャーがあるのでイメージできると思う

https://github.com/apache/airflow/discussions/42014

１）doc_md 以外のプロパティ

以下の公式ドキュメントを確認したところ、
doc_md 以外にもあるみたいなのでメモ

https://airflow.apache.org/docs/apache-airflow/stable/core-concepts/dags.html#dag-task-documentation

attribute	rendered to
doc	monospace
doc_json	json
doc_yaml	yaml
doc_md	markdown
docd_rst	reStructuredText

【２】サンプル

https://airflow.apache.org/docs/apache-airflow/1.10.9/tutorial.html#adding-dag-and-tasks-documentation

demo_doc_md = """\
    #### Task Documentation
    You can document your task using the attributes `doc_md` (markdown),
    `doc` (plain text), `doc_rst`, `doc_json`, `doc_yaml` which gets
    rendered in the UI's Task Instance Details page.
    ![img](http://montcs.bloomu.edu/~bobmon/Semesters/2012-01/491/import%20soul.png)
"""

dag = DAG(
    'etl-get_from_api',
    default_args=default_args,
    description='A simple dag',
    schedule_interval=timedelta(days=1),
    doc_md = demo_doc_md
)