Index: [Article Count Order] [Thread]

Date:  Sat, 29 Jun 2002 02:55:21 +0900
From:  あまの <amapyon@....jp>
Subject:  [XP-jp:03547] Re: モデリングスタイル
To:  extremeprogramming-jp@....jp
Message-Id:  <3D1CA309.6070902@....jp>
References:  <20020627094250N.hiranabe@....jp> <20020629.003145.91280994.yo@....com>
X-Mail-Count: 03547

あまぴょんと申します。

Yo Okumura wrote:

> はじめまして。奥村ともうします。
> 
>>  http://www.modelingstyle.info/
> 
> www.modelingstyle.infoの日本語サイト、ないようならやろうかなと画策とい
> うか構想中です。
> 
> どこかでそういうアクティビティすでにあるぞ!とかご存知の方いらっしゃい
> ませんか>皆様

私も知りたいです。

ちょっと見ただけですが、意外と胸に刺さることがかかれていますね。

http://www.modelingstyle.info/general.html
を自分なりに解釈してみました。新鮮でした。

1 Readability Guidlines
可読性のためのガイドライン

1.1 Avoid Crossing Lines
線は交わらないようにしよう

1.2 Crossing Lines Jump One Another
線が交わるときはジャンプさせよう

1.3 Avoid Diagonal or Curved Lines
斜めや曲がった線は引かないようにしよう

1.4 Apply Cinsistently-Sized Bubble
大きさをそろえよう

1.5 Show Only What Yoou Have To
必要なものだけ見えるようしよう

1.6 Prefer Well-Known Notation Over Esoteric Notation
あまり使わない表記法より、よく使う表記法を使おう

1.7 Reorganize Large Diagrams Into Several Smaller Ones
図が大きくなるようならば分割しよう

1.8 Include Whitespace In Diagrams
図にはゆとりを持たせよう

1.9 Focus on Content First, Appearance Second
見せ方よりも内容に焦点をあてよう

1.10 Cleanup to Rethink a Diagram
図を新鮮に保とう

1.11 Organize Diagrams Left to Right, Top to Bottom
図は左から右、上から下に書こう

1.12 Describe Diagrams With a Note
ノートを使って、図の説明を書こう

1.13 Set a Convention for Placement of Diagram Descriptions
図の説明はいつも同じ場所に書こう

1.14 Set and Folow Effective Naming Conventions
理解しやすい名前を使おう

1.15 Apply Common Domain Terminogy in Names
郷に入れば郷に従った名前を使おう

1.16 Only Bring Language Naming Conventions into Design Diagrams
設計時にはプログラム言語を意識した名前を使おう

1.17 Indicate Unknowns with a Question Mark
分からないところは?をつけよう

1.18 Consider Adding Color Your Diagrams
色分けしてみるのもいいかもしれない

2 Guidelines for Common UML Medeling Elements
UML要素共通のガイドライン

2.1 Left-Justify Text in Notes
ノートの文字は左揃えにしよう

2.2 Name Stereotypes in <<user interface>> and <<UI>> Format
ステレオタイプでは、フルスペルは小文字、省略するときは大文字にしよう

2.3 Prefer Naming Conventions Over Stereotypes
ステレオタイプよりも名前で意図を表そう

2.4 Introduce New Stereotypes Sparingly
新しいステレオタイプは控えよう

2.5 Apply Stereotypes Consistently
ステレオタイプを使うときは一貫性に気をつけよう

2.6 Prefer Notes Over OCL to Indicate Constraints
OCLよりもノートを活用しよう