社内ライブラリやフレームワークを浸透させるには、「チュートリアル」「小さなサンプル」「レビュー」が必要 | gihyo.jp

濃縮還元オレンジニュース 社内ライブラリやフレームワークを浸透させるには、「チュートリアル」「小さなサンプル」「レビュー」が必要 数年前に書いた社内ライブラリの文書が今でも改訂され参照されている、という経験をもとに社内用文書や教育のあり方について語ったブログ記事です。 書籍『Building Application Frameworks』（⁠John Wiley & Sons Inc）では、フレームワークの文書を「サンプル」「⁠レシピとクックブック」「⁠契約」「⁠デザインパターン」「⁠概要」「⁠リファレンス」「⁠設計ノート」に分類しているようで、ブログ筆者はその中で最も欲しいものはサンプルである、という結論に達したようです。また、過去に作られたアプリケーションからコピー&ペーストされることが多く、質の悪いコードのまま利用されることがあるという事実により、正しいコピペ素材を提供するためライブ

[toton]

「正しいコピペ素材を提供するためライブラリの最頻イディオムをサンプルつきクックブックとしてまとめることが最善である」

[bigbro]

「正しいコピペ素材を提供するためライブラリの最頻イディオムをサンプルつきクックブックとしてまとめることが最善である」

[restartr]

リファレンスなんて書いても読んでもらえない。コピペして試せるチュートリアルや、サンプルが有効。

[cubed-l]

効率化は図れそうだが、次のサンプルを書ける人材に育つかが疑問だな

[walkinglint]

> 正しいコピペ素材を提供するためライブラリの最頻イディオムをサンプルつきクックブックとしてまとめることが最善である，

[skelton_boy]

社内ライブラリやフレームワークを浸透させるには，「チュートリアル」「小さなサンプル」「レビュー」が必要

[yachimon]

社内資料作りの参考に。

[nettabo]

「正しいコピペ素材を提供するためライブラリの最頻イディオムをサンプルつきクックブックとしてまとめることが最善である」には激同。