teratail header banner
teratail header banner
質問するログイン新規登録

回答編集履歴

5

読む側から見る話を追記

2016/10/07 11:27

投稿

LLman
LLman

スコア5592

answer CHANGED
@@ -7,6 +7,11 @@
7
7
  かりに、たまたま職場で「N」でANDを表すのが流行ってたとしても、
8
8
  たとえば**数年後**に人が入れ替わってたら、**保守**のさまたげになります。
9
9
 
10
+ こういう略語の誤解の極端なケースでは、色だとすら判明しない場合もあります。
11
+
12
+ 書いた側から見ると、「赤と青」だと知ってるから略したくなりますが、
13
+ **読む側から見る**と、「readNotrue」とか、何かの略と錯覚するかもしれません。
14
+
10
15
  ---
11
16
 
12
17
  そもそも、「少しでも短く略したい」という方針も推奨できません。
@@ -21,4 +26,4 @@
21
26
  すくなくともANDをNに略すのは過剰です。
22
27
 
23
28
  もし、```redNblue```にするくらいなら、```red_blue```の方が、
24
- 誤読の余地が減るので、二択ならこっちの方が良いと思います。
29
+ 誤読の余地が減るので、二択ならこっちの方が良いと思います。

4

強調部分などを微修正

2016/10/07 11:27

投稿

LLman
LLman

スコア5592

answer CHANGED
@@ -1,6 +1,6 @@
1
1
  (命名だけを問題にして、かつ、その選択肢の中から選ぶなら)
2
- ```RedAndBlue```、または、```red_and_blue```を**推奨**します。
2
+ ```RedAndBlue```、または、```red_and_blue```の方選択します。
3
- 一方、```redNblue```は、推奨できません。**隠語的**だからです。
3
+ 一方、```redNblue```は、**推奨できません**。**隠語的**だからです。
4
4
 
5
5
  なるべく多くの人間に通じる**普遍的な言葉**を選んでください。
6
6
 
@@ -14,11 +14,11 @@
14
14
  タイプ数を減らしたい気持ちは分からなくもないのですが、
15
15
  現代では**短さより可読性の高さを優先**するのが、筋の良い命名法です。
16
16
 
17
- 『リーダブルコード』でも、字数よりも理解にかかる時間を短くせよ、
17
+ 『リーダブルコード』でも、**字数よりも理解にかかる時間を短くせよ**
18
18
  という主旨のことが書いてあったと思います。
19
19
 
20
20
  じゃあ、どこまでも長くなってもいいかというと、それも微妙ですが、
21
21
  すくなくともANDをNに略すのは過剰です。
22
22
 
23
23
  もし、```redNblue```にするくらいなら、```red_blue```の方が、
24
- **誤読の余地**が減るので、こっちが良いと思います。
24
+ 誤読の余地が減るので、二択ならこっちの方が良いと思います。

3

命令口調を柔らかく修正

2016/10/07 11:01

投稿

LLman
LLman

スコア5592

answer CHANGED
@@ -9,7 +9,7 @@
9
9
 
10
10
  ---
11
11
 
12
- そもそも、「少しでも短く略したい」という考えは捨ててください
12
+ そもそも、「少しでも短く略したい」という方針も推奨できません
13
13
 
14
14
  タイプ数を減らしたい気持ちは分からなくもないのですが、
15
15
  現代では**短さより可読性の高さを優先**するのが、筋の良い命名法です。

2

命名だけを問題にすることを冒頭で表明

2016/10/07 09:48

投稿

LLman
LLman

スコア5592

answer CHANGED
@@ -1,4 +1,4 @@
1
- 設計とかは問題視せず、かつ、その選択肢の中から選ぶなら)
1
+ 命名だけを問題にして、かつ、その選択肢の中から選ぶなら)
2
2
  ```RedAndBlue```、または、```red_and_blue```を**推奨**します。
3
3
  一方、```redNblue```は、推奨できません。**隠語的**だからです。
4
4
 

1

誤読の余地について追記

2016/10/07 08:33

投稿

LLman
LLman

スコア5592

answer CHANGED
@@ -3,6 +3,7 @@
3
3
  一方、```redNblue```は、推奨できません。**隠語的**だからです。
4
4
 
5
5
  なるべく多くの人間に通じる**普遍的な言葉**を選んでください。
6
+
6
7
  かりに、たまたま職場で「N」でANDを表すのが流行ってたとしても、
7
8
  たとえば**数年後**に人が入れ替わってたら、**保守**のさまたげになります。
8
9
 
@@ -17,4 +18,7 @@
17
18
  という主旨のことが書いてあったと思います。
18
19
 
19
20
  じゃあ、どこまでも長くなってもいいかというと、それも微妙ですが、
20
- すくなくともANDをNに略すのは過剰です。
21
+ すくなくともANDをNに略すのは過剰です。
22
+
23
+ もし、```redNblue```にするくらいなら、```red_blue```の方が、
24
+ **誤読の余地**が減るので、こっちが良いと思います。