@kome さん
私も同意見です。
ETL処理内容を定義書で管理するのは、ドキュメント作成の作業負荷になる上、あまり活用されない…という所感です。
Domo画面で一目瞭然といった状況をつくることが効率的だと考えます。

ETLタイルの「メモ」は以下の場面では有効だと思います。
・結合タイルでの結合キーの説明
・スクリプトタイルで計算列の定義

バージョン管理としては、ETLを更新した際のメモ書きに概要をしっかり記載することを徹底することで、第三者もどのバージョンから処理が変わったかなど遡ることができます。

（過去のバージョンに戻せば、当時のETLを確認することもできるので、このメモは何かしら書くことをおすすめします。）
メモ欄には改行できず長文には不向きなので、バージョンNoに対してだけドキュメント管理というのも手かもしれませんね。

以上、ご参考になれば幸いです

@kome san

はじめまして、私はデータフローに関しては設計書（パワポ、webのナレッジ管理システムに）つくっています。
どういう要件のデータフローを作ったのか、既存のデータセットではなぜダメなのか？を観点に作ってます。

理由なんですが、

ユーザが勝手な解釈をして（便利だなと勝手に想像）流用をし始める。
作ったものが独り歩きする。

これらを防ぐために、作った経緯、定義、ロジックのなり立ちは、残すべきと考えてます。
あと自分が作ったこと自体を忘れる⇒そのための振り返りのため

※特にデータフローに関しては