読みにくい日本語ドキュメントを書いてしまう人たち - None is None is None
2015-05-09 読みにくい日本語ドキュメントを書いてしまう人たち ソフトウェア開発の仕事をして４年目になるのですが、未だに我慢できないことがあります。 それは社内ドキュメントが読みにくい日本語で書かれていることが多いということです。 ドキュメントの情報が古い、そもそも書かれていない、間違っているといった話ではありません（いや、この問題もあるんですが・・・）*1。 私が言いたい読みにくい日本語とは、書いた人が表現したい内容は理解できるし内容自体も間違ってはいないが、 曖昧だったり、主語がわかりづらかったり、ドキュメントにふさわしくない語尾だったりで読んでいてムカついてくる文章のことです。 読みにくいと思う日本語の例 勤め先のドキュメントを引用すると色々問題なので、Wikipediaから残念な例を引用します。 MySQLやPostgreSQLなど主要なRDBMSへの接続については、それぞ
Pythonによるデザインパターン（目次） - None is None is None
これは『Rubyによるデザインパターン』（ラス・オルセン著 ピアソン・エデュケーション刊）をPythonに翻訳してみようというシリーズです。 Rubyによるデザインパターン 作者: Russ Olsen,ラス・オルセン,小林健一,菅野裕,吉野雅人,山岸夢人,小島努出版社/メーカー: ピアソン桐原発売日: 2009/04/01メディア: 単行本購入: 13人 クリック: 220回この商品を含むブログ (66件) を見る デザインパターンの原則から 変わるものを変わらないものから分離する インターフェイスに対してプログラムし、実装に対して行わない 継承より集約 委譲、委譲、委譲 必要になるまで作るな（これは「Rubyによる〜」の筆者による） 記事 Template Methodパターン Strategyパターン Observerパターン Compositeパターン Iteratorパターン C
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
