Qiita Teams that are logged in
You are not logged in to any team

Log in to Qiita Team
Community
OrganizationAdvent CalendarQiitadon (β)
Service
Qiita JobsQiita ZineQiita Blog
331
Help us understand the problem. What is going on with this article?
@e99h2121

結局UMLとかシーケンス図とかAWSの図とかどれで描くと良いのよ?と思ったときの選択肢

自身のプライオリティによりますが、いくつか。

  1. Markdownで幅広く再利用性を利かせたい、長期的に丁寧に版管理したい
  2. 自分自身の操作性、描きやすさと、見た目
  3. 俄然手軽に、短期的に、Onlineでいつでもどこでも

いずれかという視点で考えると良いのかなと思い、並べてみました。

1. 長期的に: Markdownで幅広く再利用性を利かせたい、丁寧に版管理したいなら

  • Markdownで描くことのメリットは再利用性。
  • 将来的に追記・編集、自分以外の誰かが手を入れる可能性が高い。
  • 現在のドキュメントだけでなく多種説明資料、媒体に転用する可能性がある。

...という点で差分管理をしたいなら、以下。

VSCodeでPlantUML

上記参考で以下。
image.png

Alt+D でプレビュー起動。
Ctrl + Shift + P でコマンドパレットを起動し、出力。

png, svg, eps, pdf, vdx, xmi, scxml, html で出力可能。
シーケンス図も書けます。

image.png

トラブルシュート

あるいはTypora

image.png

その他 flowchart.js, Growi

2. 自分自身の操作性、描きやすさと、見た目なら

  • 多分開発用途で、編集もせいぜい同じツールを使える開発メンバー。
  • 設計資料だから開発チーム内でまあまあ便利に使えるのがベスト。

...という点なら、以下。

こちらもVSCodeで、Draw.io

デフォルトでは .drawio, .dio, .drawio.png, .drawio.svg などの拡張子のファイルを開けば、DrawioのUIで開いてくれる。

image.png

トラブルシュート

JavaScript mermaid.js

npm install mermaid --save-dev

<!DOCTYPE html>
<html lang="ja">
<head>
  <link rel="stylesheet" href="https://unpkg.com/mermaid/dist/mermaid.min.css">
</head>
<body>
<div class="mermaid">
  sequenceDiagram
    A->>B:起動
    B->>C:依頼
    C->>B:返答
    loop 
      B->>B:処理終了まで
    end
</div>

<script src="https://unpkg.com/mermaid/dist/mermaid.min.js" charset="UTF-8"></script>
<script>
  mermaid.initialize({
    startOnLoad:true
  });
</script>
</body>
</html>

image.png

あるいは Python Diagram as Code(Diagrams)

等など。
以上このゾーンは結局お好みかもしれない。

3. 短期的に: 俄然手軽に、Onlineでいつでもどこでもなら

  • とにかく描いて議論して話を固めたい。まだ初期段階だから色々変わりそう。
  • 開発チーム以外も見る、編集するから道具にこだわれない。

...という点なら。

Google Workspace

意外とシンプルに描けます。

チームでああだこうだ言いながら書いても良いかもしれない。

yUML

こちらもお気軽におしゃれな絵が描ける。

image.png

ほか色々 Cacoo、Cloudcraft、Hava

結局 Google Sheets や Excel

Google Sheets やExcelという選択肢になる現場もあるとおもう。Good luck。

番外

その他、Miscたち。

素材

スクリプトを作ってしまうという選択肢

まとめ

  • 長期的に少しずつメンテして育てたい
  • 短期的にササッと書き捨てたい

以上、選択肢とプラスアルファの順に並べてみました。
参考になればさいわいです。

331
Help us understand the problem. What is going on with this article?
Why not register and get more from Qiita?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
e99h2121
2003年新卒入社した「人事給与システムのリーディングカンパニー」で保守開発をしています。Qiitaではポエマー、Zennで息抜き。2016aug生まれ娘、2018oct生まれ息子に精神を鍛えられている日々
works-hi
「はたらく」を楽しく!に向けて大手企業の人事業務から変えていく HR業界のリーディングカンパニー

Comments

No comments
Sign up for free and join this conversation.
Sign Up
If you already have a Qiita account Login
331
Help us understand the problem. What is going on with this article?