ベストプラクティス

Sailsでの開発において、コントリビューターが長年にわたって確立してきた、文書化されていない多くのベストプラクティスやワークフローの改善があります。このセクションでは、その基本の一部を文書化しようとしていますが、設定方法について質問がある場合や、自身のツールチェーンを共有したい場合は、必ずGitterにアクセスしてください。

Sailsのコアを操作する最良の方法は、リポジトリをフォークし、git cloneでファイルシステムにクローンし、npm linkを実行することです。テストを記述することに加えて、多くの場合、サンプルプロジェクトをハーネスとして使用したくなるでしょう。それを行うには、サンプルアプリにcdし、npm link sailsを実行します。これにより、サンプルアプリのnode_modulesディレクトリに、ローカルにクローンしたSailsのバージョンを指すシンボリックリンクが作成されます。これにより、変更を加えるたびにフレームワークをコピーする必要がなくなります。sails liftの代わりにnode appを実行することで、サンプルアプリにローカルのSails依存関係を強制的に使用させることができます（ただし、sails liftは、もし存在すればローカルの依存関係を使用すべきです）。このようにしてコマンドラインツールをテストする必要がある場合は、サンプルアプリからnode node_modules/sails/bin/sailsとしてアクセスできます。たとえば、sails newに取り組んでいて、手動でテストしたい場合は、node node_modules/sails/bin/sails new testProjを実行できます。

異なるバージョンのSailsのインストール

リリース	インストールコマンド	ビルドステータス
最新	npm install sails	安定版
edge	npm install sails@git://github.com/balderdashy/sails.git

テスト用の未リリースブランチのインストール

一般的に、以下のようにGithubから直接Sailsをnpm installできます

# Install an unreleased branch of Sails in the current directory's `node_modules`
$ npm install sails@git://github.com/balderdashy/sails.git#nameOfDesiredBranch

これは、ホットフィックスをテスト/インストールする場合に便利であり、一般的に知っておくべき良いことです。

プルリクエストの送信

0. 初めてフォークしてPRを送信する場合は、こちらの指示に従ってください。
1. リポジトリをフォークします。
2. 変更に対するテストを追加します。リファクタリングとドキュメントの変更のみ、新しいテストは必要ありません。機能を追加したり、バグを修正したりする場合は、テストが必要です！
3. テストをパスさせ、構文ガイドラインに従っていることを確認してください。
4. CHANGELOG.mdに（masterの直下に）行った変更の行を追加します。
5. フォークにプッシュし、適切なブランチにプルリクエストを送信します
   • マスター
     • 「edge」バージョンに対応します。これは、Sailsの最新の、まだリリースされていないバージョンです。ほとんどのプルリクエストはここに送信されるべきです。
   • 最新（または「安定版」）
     • npmでの最新の安定版リリースに対応します（優先度の高いホットフィックスがある場合は、その説明とともにPRを送信してください）。