Factor/FAQ/Factor 開発への協力

git で開発状況を追跡するにはどうすればよいですか？

GIT リポジトリを参照してください。

Factor の開発に加わるにはどうすればよいですか？

最も良い方法は、自分の git リポジトリを作ることです。やり方は、Chris Double が ブログの記事で説明してくれています。git リポジトリを作成したら、コードベースに好きなように手を入れてください。そして、関係する部分を開発している人に知らせてください。あなたの加えた変更が有益だとみなされれば、メインの Factor リポジトリに取り込まれるでしょう。なお、あなたの公開リポジトリにパッチをプッシュする前に、.git/config ファイルに次の形式であなた自身に関する情報を記述し、あなたのプッシュするパッチに署名が付くようにしてください。

[user]
    name = "Manuel Lopez Garcia"
    email = "manuel@lopez.mx"

git リポジトリはどこに置けばよいですか？

GitHub: http://github.com/ を使用できます。

Factor リポジトリにコードが受け入れられるための条件は何ですか？

Factor プロジェクトは、協力者がコントリビュートしたコードに関して、非常に厳格な要件を課しています。リポジトリ内のすべてのライブラリは最低限のクオリティコントロールを確実にパスするよう、継続的インテグレーションが使われています。

重要な要件は以下のとおりです。

• コードは、コードベースのほかの部分と同一の名前付け・インデント規約に従っていなければなりません。
• コードには適切なドキュメントが伴っていなければなりません。
• コードには適切かつテストの対象範囲 (adequate and test coverage) がなければなりません。
• すべてのユニットテストと help lint によるチェックをパスしなければなりません。
• ボキャブラリのメタデータが authors.txt、summary.txt、および tags.txt の形で提供されていなければなりません。

新しく協力者に加わる場合は、さらに 2 つの要件が追加されます。ひとつは、許可を得ることなく core および basis 内のものに変更を加えてはいけないということ、もう一つはすべてのボキャブラリは extra から出発しなければならないということです。

バイナリパッケージは、ビルド時のチェックをすべてパスしなければリリースされないので、特定のコードをロードできなかったり、数日以上テストをパスしない状態が続けば、該当するコードは unmaintained に移される場合があります。コードの作者は、ビルドに失敗する原因を取り除いた後、いつでもコードを元に戻すことができます。

自分のパッチをメインリポジトリにマージしてもらうにはどうすればよいですか？

連鎖性 IRC チャンネルに来て、slava か erg に変更内容のレビューを依頼してください。あらゆるパッチは、コア開発者のいずれかによるコードレビュープロセスを経てから、リポジトリにマージされます。私たちは、提供されたコードを拒否する権利を留保します。

Factor プロジェクトへの貢献という形を取りたくない作業中のコードはどこに保存すればよいですか？

Factor 付属のコアライブラリ以外のものが置かれる extra/ にコードを置くのも一つの方法です。もう少し整理して配置したい場合には、ボキャブラリの検索パスにも含まれている work/ という名前のディレクトリにボキャブラリを置くか (たとえば extra/foobar/foobar.factor または work/foobar/foobar.factor など)、または現在の作業ディレクトリに置いてください。vocabs.loader ボキャブラリの vocab-roots 変数を修正すれば、ボキャブラリの検索パスに新しいディレクトリを追加することもできます。ヘルプの Factor ソースツリーの外部でコードを操作するも参照してください。

Cygwin で自分のリポジトリにプッシュしようとすると、次のようなエラーメッセージが表示されるのですが？

fatal: exec failed
fatal: The remote end hung up unexpectedly
error: failed to push to 'foo@bar.com:factor.git'

Cygwin のインストーラで OpenSSH をインストールしてください。これで問題は解決されるはずです。