自己文書化コード
自分自身
の
意味
を
きちんと
説明
できている
コード
「それ自体がドキュメント」
マジックナンバーを使わない
分かりやすい変数名を付ける
細かな関数に分割する
self-documenting code
self-describing code
自己
+
文書化
+
コード
対義語.icon
well documented code
ソースコード
(
source code
)
ドキュメント
(
document
)
コードレビュー
(
code review
)
生産性
(
productivity
)
可読性
抽象化
国語力
暗黙の前提
code readability
literate programming
natural language programming
controlled natural language
autological word
Python
-
ドキュメンテーション文字列
(
docstring
)
Self Documenting Code
Self-documenting code - Wikipedia
#literate-programming