ビジネスコミュニケーション
ビジネスコミュニケーション、ビジネスライティングに関するナレッジやノウハウ。分かりやすく正確な文書を書く方法や、無駄なく最小のコストで情報伝達をするための考え方など。
ビジネスコミュニケーションノウハウ
- ベストプラクティス
- 禁止事項・アンチパターン
- ドキュメンテーション
雑多なメモ
トピックにまとめられそうになったらまとめます。
- 「誰でもわかるようなドキュメントを書け」ってのは「ググっても出てこないような暗黙知を無くすようにする」ことであって「未経験者にもわかるように」ってことじゃないんだからね！
- オブジェクト指向でも関数型言語でも同じだけど、抽象化の方法は1つじゃないので、設計者が何を思って何をどう抽象化したのかという点がわからない。ドキュメントはこの点のみ必要だと思う。設計者の意図