サンプルとは良い考えです。特に、クラスが複雑なAPIをもつ場合には。 しかし、サンプルはドキュメントの一部でしかありません。 ドキュメントの代わりにサンプルだけを作るのはやめましょう。 ドキュメントとサンプルは共に 'docs' サブディレクトリにストアしてください。
そのクラスが、コンパイルする必要のあるものである場合や、 特別な拡張やプログラムを必要とする場合、および、 （テンプレートや画像などの）追加ファイルが正しくインストールされている 必要のある場合は、テストスクリプトの作成が推奨されます。 'tests' サブディレクトリにストアしてください。