手書き風、READMEにアーキテクチャを示したい場合は Excalidraw、 社内のモデリング図作成ツールとしては eraser.io を使うのがMy Workflow。

eraser.io

app.eraser.io

  • Diagram as Code
    • Editorが優秀
      • サジェストもされて宣言したobjectも認識されるのでサクサク
      • 構文も個人的にmermaid(その他)よりシンプルでヒューマンリーダブル、エディタ上にhelpがあり完結でわかりやすい
  • Diagram
    • キーボードショートカットがFirstViewで見える状態なので学習コスト低くサクサク図を作成できる
    • draw.ioでの操作感を超える
    • フリーキャンバスが優秀
    • DocにDiagramを埋め込める
  • Share
    • アカウントがあればTeamじゃなくてもeditできる(commentできる)
  • Pros
    • Notionの埋め込みに対応しており、FigmaやMiroのようにEmbedの状態で表示がヌルヌル動く(重要)
    • Docもあり、補足ができるし、Doc上にDiagram(Canvas)を埋められる
    • AI生成でDiagram as Codeでたたきが作れる
    • 豊富なDocs,快適なUX
  • Cons
    • AI生成のみでの図の最終FIXはまだ厳しそう
    • 無料枠だと5ファイルまで。
    • Teamでの利用が一人当たり10(12)ドル。高い。。
  • 所感
    • エンジニア向けドキュメンテーションツールのLinearという感じ。チームだと高いので要検討だが、僕個人として12ドル分の価値は発揮できる可能性を感じており、課金余地あり