
189
4
●
ユーティリティの利用方法
●
外部ライブラリの利用方法
●
テストコードの書き方
チュートリアル
オープンソースソフトウェアの公式サイトでは、API仕様書等のド
キュメントに加えて、チュートリアルが提供されていることがあります。
たとえば、JavaScriptのフロントエンドフレームワークであるReactの
公式サイトには、三目並べゲームを題材としたチュートリアル
※ 22
の
ページがあります。こういったチュートリアルは、ハンズオンで手を動
かしながら、数時間程度でちょっとしたプログラムを完成できるように
設計されています。初学者は、ドキュメントを読んで得た知識を、
チュートリアルの実践を通して強固なものにすることができます。ある
いは、先にチュートリアルで手を動かしてイメージを掴んだ後にドキュ
メントに目を通すことで理解がしやすくなります。
チュートリアルの提供は、個別の開発プロジェクトでも活用可能なプ
ラクティスです。新規の参画者は、開発環境構築手順書に従ってローカ
ルマシンに環境をセットアップしたら、チュートリアルを実施するよう
にします。
チュートリアルの内容は、半日から一日程度で終えられる程度のシン
プルな題材とします。アプリケーション基盤の実装にはリアルなユース
ケースを選んで用いる方がよいと述べましたが、チュートリアル用には
サンプルのユースケースで構いません。
また、チュートリアルでは構成管理の流れも体験できるようにしてお
くとさらに効果的です。たとえばGitを導入している場合、GitHubか
らローカルへプロジェクトをクローンし、練習用のブランチを作成しま ...