You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.

READMEを始め、ソフトウェアのドキュメント全般を書く技術というものをもっと洗練させていきたい。要件定義書のようなものだけでなく、開発方針や設計方針、API定義などなど。 これらのドキュメントをしっかりと整備するだけで、レビューの質も上がり新しい人が入ったときもスムーズに意識のズレなく開発ができる。はずだが、なかなかドキュメントの上手い書き方や管理の仕方というものは、コーディングのそれとは違い議論が活発ではない。 最近試してみたこと そういったドキュメントの中でも、"開発方針"や"設計思想"をどう残していくかということを考えている。それらを残しておくことで、コーディングのときも立ち戻る場所ができ、大きく道を踏み外さなくなる。 例えば、レイヤードアーキテクチャのようなものの"境界"をドキュメントにしていく。MVCでもクリーンアーキテクチャでも何でも良いけど、それらのアーキテクチャではそれぞ

モノ @Monolith_tb @ro_ki_ スタイリッシュを目指してユーザーフレンドリーではなくなってしまうというアレ(売り場を逐一聞かれて店員さんの無駄な雑用が増えるだけという 2018-01-18 18:10:01 ろきお @ro_ki_ @Monolith_tb カレンダー見に行ったんだけど、表示の導線が用意されてないからなのか、ダイアリーのフロアで「カレンダーは6階です」って書いたボードもって店員さんがうろうろしてて気の毒だった…… 2018-01-19 09:55:28