オープンソースプロジェクトを開始するためのチェックリスト[終了]


50

オープンソースプロジェクトを開始することは、単に公開リポジトリにソースコードを投げて、それで満足することではありません。技術的な(ユーザー以外の)ドキュメント、貢献方法などの情報が必要です。

重要なことを行うためのチェックリストを作成する場合、それに何を含めますか?


1
+1良い質問。お勧めします: gawande.com/the-checklist-manifesto
JeffO

2
Karl Fogelの本(オリジナルのsubversionの著者の1人)の本、Producing Open Source Software-成功するフリーソフトウェアプロジェクトの実行方法をお勧めします 。これはO'Reillyの本です。
マイケル

Karl Fogelによるオープンソースソフトウェアの作成は、それを支援するはずです。この本は完全にオンラインで入手できます。
コヨーテ21

回答:


34

最も重要なことは:

  • 自分でプロジェクトを使用し、それを使用して楽しめる便利な状態にします。プロジェクトが機能し、役立つことを確認してください。

私が初期の優先事項に置いていたものは次のとおりです。

  • 単純な「それは何ですか?」いくつかのディスカッションフォーラム(電子メールまたはチャット)およびソースコードリポジトリへのリンクを含むWebサイト
  • コードがコンパイルされ、通常は動作することを確認してください。他の人の作業が中断されるため、進行中の作業や物事を壊す半ばパッチをコミットしないでください。
  • よく知られているライセンスでコードリポジトリにライセンスファイルを配置し、著作権所有者(おそらくあなたまたはあなたの会社)にマークを付けます。ライセンスを省略したり、ライセンスを作成したり、あいまいなライセンスを使用したりしないでください。
  • HACKINGファイルに記載するか、READMEに記載する方法について説明してください。これには、パッチの送信先、パッチのフォーマット方法、コードのインデント規則、プロジェクトの他の重要な規則が含まれている必要があります
  • バグを報告する方法に関する指示があります
  • メーリングリストまたはあなたのフォーラムが何であれ助けてください

それらの優先順位の後、私は言うでしょう:

  • ドキュメント(これにより、メーリングリストでの作業が節約されます...リストの投稿からFAQを作成するのは簡単です)
  • 「通常の」方法でやってみてください(独自のビルドシステムを発明したり、おかしなシステムを使用したり、1スペースのインデントを使用したり、学習曲線を追加するので一般的にいらいらさせたりしないでください)
  • プロジェクトを促進します。マーケティングマーケティングマーケティング。あなたをカバーするブログやニュースサイトなどが必要です。そして、人々が興味を示したら、彼らと話をして、彼らがそれを動作させ、パッチを確認する必要があります。関連プロジェクトのフォーラムであなたのプロジェクトに言及するかもしれません。
  • 可能な限り迅速にパッチを常に確認して受け入れます。すぐに完璧です。数日以上、あなたは多くの人々を失っています。
  • プロジェクトに関するメールには、できる限り迅速に返信してください。
  • 歓迎/ポジティブ/楽しい雰囲気を作ります。ジャークにならないでください。お願いし、ありがとうと称賛を伝えます。ジャッケスを追い出し、コミュニティを汚染し始めます。できるときに直接会って、絆を結ぶようにしてください。

潜在的な法的問題はどうですか?実装に特許アルゴリズムが誤って含まれていないことをどのように確認しますか?
デン

残念ながら、それを判断することはできません。コードのチャンクを考えると、関連する特許を見つけるために必要な検索用語を知る方法はありません。これは、ソフトウェア特許がそのような問題である理由の1つです。適用される特許があることを知っている場合もありますが、適用される特許がないことを確信する方法を聞いたことはありません。否定を証明するのは難しい。特許は十分に大きなトピックであり、おそらく彼ら自身の質問であるべきです...
Havoc P

17

まず、エントリーの障壁を下げます。これは次のことを意味します。

  • インストールを簡単にする、
  • 変更を簡単にする、
  • プロジェクトを見つけやすくする、
  • やりたいことをすべて簡単にするだけです。

どうやって?

  • ドキュメントで考えられるすべての質問に答えてください。
  • 使いやすいビルドシステムを作成し、
  • コードをクリーンアップします。スパゲッティコードの作業を好む人はいません。
  • 人々が必要としているものを作りましょう。
弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.