濃縮還元オレンジニュース 社内ライブラリやフレームワークを浸透させるには、「チュートリアル」「小さなサンプル」「レビュー」が必要 数年前に書いた社内ライブラリの文書が今でも改訂され参照されている、という経験をもとに社内用文書や教育のあり方について語ったブログ記事です。 書籍『Building Application Frameworks』(John Wiley & Sons Inc)では、フレームワークの文書を「サンプル」「レシピとクックブック」「契約」「デザインパターン」「概要」「リファレンス」「設計ノート」に分類しているようで、ブログ筆者はその中で最も欲しいものはサンプルである、という結論に達したようです。また、過去に作られたアプリケーションからコピー&ペーストされることが多く、質の悪いコードのまま利用されることがあるという事実により、正しいコピペ素材を提供するためライブ
![社内ライブラリやフレームワークを浸透させるには、「チュートリアル」「小さなサンプル」「レビュー」が必要 | gihyo.jp](https://cdn-ak-scissors.b.st-hatena.com/image/square/05764efc54855f2bc94b989cbba010b33d6324f9/height=288;version=1;width=512/https%3A%2F%2Fgihyo.jp%2Fassets%2Fimages%2FICON%2F2007%2F003_orange.png)