注目コメント算出アルゴリズムの一部にLINEヤフー株式会社の「建設的コメント順位付けモデルAPI」を使用しています
いいこと書いてあったので一言何か言おうと思っていたのですけど、すっかり忘れていた。。。 ドキュメン... いいこと書いてあったので一言何か言おうと思っていたのですけど、すっかり忘れていた。。。 ドキュメントって使い方次第では毒にも薬にもなるのですけど、プログラミングほどお作法や考え方がまとまっていないと常々感じております。 コーディングルールならぬドキュメンティングルールって案外重要なのですが、いろんなプロジェクトの様子を聞いたところ、なんとなくの過去踏襲って事例が多く、きちんと定めてないチームも多いんですよね。 プロジェクト特性とドキュメンティングルール 機能仕様書を読みやすくするためのテクニックはどれも納得いくもので、参考にすべき内容と思いますが、一点だけ補足しておきたい項目があります。 【2】仕様書テンプレートは作らない 企業や組織内で、「機能仕様書に書くべき項目を定型テンプレートにまとめておきたい」という誘惑に駆られるかもしれませんが、一般論として筆者はお勧めしません。 開発プロジェク
2019/02/13 リンク