「オープンソースで、パッチを提出してください」と表現すると、わかりやすくなりますか？

「オープンソースです、パッチを提出してください」というレトルトとは何ですか？、多くの人々は、パッチを提出するように単に求めることはsimply慢で失礼だという意見を表明しました。

しかし、私には、オープンソースプロジェクトの開発者として、あなたが実装できるよりも多くの機能要求をメーリングリストで見るように思われます。したがって、ユーザーが「機能Xを見たい」と言ったとき、問題の真実は、通常、パッチを自分で提出しない限り、実装される可能性はかなり低いということです。また、ユーザーをコントリビューターに変えるのに必要なのは、ちょっとした励ましだけでもよい場合もあります。

一方で、失礼として脱落することによって（潜在的な）貢献者を怖がらせたくありません。

では、「機能を要求する代わりにパッチを提出してください」と友好的な方法でどのように言いますか？

更新：すべての提案をありがとう！それらのほとんどはかなり長い説明が必要だと思います。しかし、私はむしろ（a）1日おきに同じことを説明する（時間がかかりすぎる）、または（b）メールに貼り付けるスニペットを使用する（非人称ですぐに取得する）のを避けたいので、私がリンクできるドキュメントにこれを書いた人はいますか？

（テストの作成方法、コードのコンパイル方法、パッチの提出方法などのプロジェクト固有の事項は、もちろん文書化する必要がありますが、これらの技術的な問題はCONTRIBUTING.txtに記載する必要があります。）

あなたはしません。

私がそれを経験している限りでは、候補者はいじくり回しであり、単にそれを要求するだけでは機能要求を送信しません。通常、彼らは既にある程度の参加でそれを要求します：

• [...]なら甘いのではないでしょうか？A、B、Cを実行することも可能かもしれません。
• パッチはここにあります/ここに修正があります[...]。
• 私はパッチを書くことを考えています[...]フィードバックを使うことができます/手伝うことに興味がある人です。
• 等。

機能リクエストを完全に送信するコーダーは、通常、何らかの理由でそうします。それらのいくつかが含まれます（そして、最後の2つが例えばWordPressで起こるという事実を知っています）。

• 彼らは他のオープンソースプロジェクトに深く関わっている、つまり時間がない。
• 彼らはフリーライダーであり、物事をそのように保つつもりです。
• それは彼らのスキルレベルを超えた方法/彼らが何も知らない言語で書かれたものです。
• 彼らはより良いオプションの欠如からソフトウェアを使用し、batsh * t ^ \ bコードの臭い山に対処したくない。
• 以前のパッチが無視されたり拒否されたりしたため、彼らはもはや気にすることはできません。つまり、時間を無駄にしていると思います。

より一般的には、機能のリクエストは、たとえそれを望んでもパッチを提供できなかったエンドユーザーから来ます。特に、発券システムの外部で提出された場合。

あなたの最も重要な優先事項は、潜在的な/既存の貢献者を先送りしないことであり、積極的に新しい貢献者を募集することではないでしょう。これは非常に重要であり、これは経験から言います。新しいコードベースを取得する奇妙な方法があります。これは、コードを大まかに読んでそれをある程度理解し、チケットシステムに飛び込み、簡単に見えるバグを修正して内部を深く学ぶ（そしてファイリングする）私がテストするように新しいもの）。長年にわたって、私はいくつかのプロジェクトに数十のチケットとパッチを殺到させてきました。多くの場合、これらのチケットは、文書化された診断手順と単体テストが添付されている場合を含めて、タイムリーな注意をほとんどまたはまったく取得しません（謝辞でも、それを維持するなど）。

要するに、無料で仕事をする時間に制限がないことを説明します。（「無料」のビットはスキップできます）、彼らは好きなときにいつでも貢献できること、それは「あなたの」プロジェクトではなく、その全員のプロジェクトです。

「本当にすみません、それは素晴らしいアイデアですが、他のすべての作業で忙しすぎているので、リストに追加しますが、本当にこれを取得したい場合は、プロジェクトに貢献することで私たちを助けてくれたら、それは素晴らしいことです。プロジェクトに変更を加えるのに役立つドキュメントがあります。彼らはここにいるので、スキルと時間があるならそして、私たちを助けたいと思ったら、変更を加えてパッチを送ってください。プロジェクトの標準に合うように、それを入手したときに、いくつかのmodを作成する必要があるかもしれませんが、少なくともこの作業の足がかりを提供してくれたことに大きな感謝を寄せています。

もちろん、パッチを要求し始めたら、それをチケットシステムに長時間置いたままにすることは決してできません。あなたはそれを好まないかもしれませんが、パッチが来続けたい場合は必要です。

礼儀正しく、状況を明確に説明してください。次のようなものはどうですか：

ご意見ありがとうございます。お客様の機能は非常に興味深いと思いますが、当社の製品で最も要求された機能を実装する努力にもかかわらず、それらすべてを実装する十分な時間はありません。開発者の方は、プロジェクトがオープンソースであるため、プロジェクトに貢献して参加できます。

「なぜあなたがリクエストに私を悩ませているのですか？私はあなたのために無料で仕事をするためにここにいるのではありません。この機能が必要なら、自分で行って実装してください」と言うことはできません。その人は非開発者であるか、製品の開発に使用される言語を知らないなどです。

だから、失礼なのではなく、プロジェクトに参加することを提案し、自分で機能を実装できない理由を説明することもできます。

失礼にならないもう1つの方法は、何も言わないことです。アプリケーションのユーザーが新しい機能を提案し、バグを報告できるWebサイトがある場合、たとえば、機能が10000ユーザーによって要求され、別の機能が10 、最初のものが最初に実装される可能性があります。

そのようなウェブサイトでは、数日または数週間後に他のユーザーから十分な賛成票を受け取っていない機能について、「自分で実装する」という提案をいつでも行うことができます。

ご依頼ありがとうございます。これをプロジェクトのバックログに追加しました。まもなく確認します。

リクエストの量が多いため、すべてのリクエストが実装されることを保証することはできません。私たちはボランティアに頼っているので、あなたが開発者であるならば、あなたの時間のいくらかを寄付して、パッチを提出することを考慮してください。それ以外の場合は、バックログを取得するために全力で取り組んでおり、できるだけ早くリクエストに対応できることをご了承ください。

本当に、そんなに大変でしたか？

「パッチを提出する」と言う代わりに、もう少し詳しく説明する必要があります。

• 現時点または近い将来にそれを行う時間がないことを明確にしてください。他の人がすぐにそれを実装したい場合は、パッチを提供する以外に方法はありません。
• 時間をかけて機能を評価してください。心からそれが好きなら、それを言っても害はありません。人々を励ます。または、機能が実際に悪いと思う場合は、それを説明する時間を取ってください。
• 最初のヘルプを提供します。あなたのようなコードベースを誰も知らない。あなたはそれをする時間がありませんが、おそらくあなたはそれをどうやってやるのか、そしてどこから始めるのかを正確に知っているでしょう。5〜10分以内に、他の人が把握するのに何時間もかかるという知識を共有できます。また、これはあなたの全体像を広めるのに役立ちます。プロジェクトにエイリアンの機能を追加する代わりに、貢献者を素敵な整数化に導くことができます。

これが私がよく言うことです...

「これは興味深い提案であり、FooBarLibがそれを実現できれば素晴らしいと思います。残念ながら、FooBarLibは私にとって暇なプロジェクトに過ぎないため、近い将来にそれを行うことはありそうにありません。したがって、これを自分で実装できる場合は、お気軽にパッチを送信してください（最初に「FooBarLibに貢献する方法」のガイドラインを必ずお読みください）。

「パッチを提出する」という優れた方法に加えて、開発者向けのドキュメントも提供して、機能を本当に必要とする他の人がプロジェクトを簡単に理解できるようにします。多くのプロジェクトは開発者にとって使い勝手が悪く、少なくとも数千行のコードを読むのに数日、システムのさまざまな部分を突く小さなテストケースを何日もかけて必要とします。

可能性のある開発者に支援を提供する場合、彼らは支援を提供する用意があります。これは、優れたコードドキュメント、フローを説明する優れたWikiページ（または優れたUML /ホワイトボードダイアグラム）、およびパッチを受け入れる簡単な方法を意味します。

githubがプロジェクトをフォークするように他の人を奨励する方法が大好きです。同じプロジェクトの複数のバージョンが異なるユーザーアカウントで存在する可能性があります。方向性が気に入らない場合は、フォークしてください。プルリクエストを簡単に送信できますが、私がそれを受け入れるのを待って立ち往生しています。

だから私の答えはしばしば、ただフォークするだけです。