Ruby
 Computer >> コンピューター >  >> プログラミング >> Ruby

オープンソースに入る最も簡単な方法

この記事は韓国語でも利用できます。DohyungAhnのおかげです!

Thom Parkinは、私の以前の記事のコメントで素晴らしい点を指摘しました:

素晴らしいアドバイス。しかし、あなたは1つの非常に重要な[最終]ポイントを逃しました。これはオープンソースであるため、ドキュメントが少し軽い機能の詳細を理解したら、ドキュメントを更新してプルリクエストを送信する必要があります。このようにして、コミュニティ全体が恩恵を受け、参加することで「コーダーの信用」を得ることができます!

トムがこれについて言及してくれてうれしいです。とても重要だからです 。ドキュメントを修正することは、あなたが使用し、愛するプロジェクトに貢献し始める最も簡単な方法です。

Rails、Rubinius、Elixirなどのプロジェクトへの私の最初の貢献は、すべてドキュメントの修正です。私は物事をより明確にするために小さな調整を行い、コードを読むことによってのみ発見できるいくつかのことを説明しました。壊れたフォーマットを修正しただけでも。これらはすべて、いくつかの大きなオープンソースプロジェクトを支援するための迅速で簡単な方法です。彼らがプロジェクトへの私の唯一の貢献であるときでさえ、彼らはまだ将来のユーザーと未来の私を助けてきました。そしてそれがオープンソースのすべてです。

ドキュメントの修正が開始するのに最適な方法である理由

ドキュメントの修正は、Railsのような大きなプロジェクトに貢献するための最も威圧的な方法です:

  • バグを修正するためにプロジェクトを設定する必要はありません 。ドキュメントを更新しているだけなので、テストやアプリを実行する必要はありません。プロジェクトをマシンに複製する必要がない場合もあります。GitHubで直接変更を加えることができます!

  • メンテナがプルリクエストに変更を加えるように依頼した場合、通常は言葉遣いや好みの問題です 。この種の変更は、コードを批判するよりも簡単に理解できます。また、テストやコードを更新する必要がなく、単語だけを更新する必要があるため、これらの変更を簡単に行うことができます。

  • ドキュメントは難しい プロジェクトメンテナのために、更新を歓迎します 。多くの場合、作成者はコードに近すぎて、紛らわしい部分がどこにあるかを理解できません。彼らは、ドキュメントが助けを必要としている場所を彼らに伝えるために、他の新しい開発者を必要としています。プロジェクトを初心者のように見るには練習が必要ですが、誰もがそのスキルを身に付けているわけではありません。

  • 最後に、影響の少ない変更で、メンテナとの関係を構築し始めています 。機能全体を提供する場合のように、プロジェクトの方向性を変えることはありません。そのため、メンテナは変更を確認しやすくなり、通常、メンテナはより迅速に応答します。マージリクエストが「これは良いアイデアですか?」にとらわれることはありません。フェーズ。

その関係を築き続けると、信頼できる貢献者と見なされるようになります。プルリクエストはより迅速にレビューされ、より複雑な機能リクエストやバグ修正について話し合うのが簡単になります。

それらは開始しやすく、実行しやすく、より迅速にマージされる傾向があります。では、なぜ最初の貢献はドキュメントの修正ではないのでしょうか?

更新されたドキュメントの投稿を開始する方法

ドキュメントの更新に貢献する重要な方法は、バグを修正するようなものです。どちらも、間違っていると感じることに敏感であることに依存しています 。注意を払う必要があります。

予期しない動作が発生した場合は、ドキュメントを更新する必要があるかもしれません。問題を解決するためにコードに飛び込む必要がある場合は、他の人にもそのことを伝えたいと思うかもしれません。読んだドキュメントのフォーマットの誤りやタイプミスにも注意を払う必要があります。修正しない場合、誰が修正しますか?

変更を加える場所とその表現方法が決まったら、変更を加えて、GitHubからプルリクエストを送信します。

それでもドキュメントを更新する最善の方法を決定しようとしている場合は、GitHubで問題を開いてください。次のようになります:

「ねえ、これは私を混乱させました。私はそれを次のように更新することを考えていました:…どう思いますか?他に言及すべきことはありますか?」一緒に、あなたは皆を満足させる言葉遣いを思い付くことができます。

最後に、応答がない場合でも落胆しないでください。大規模なプロジェクトは多くのことを行っているので、あなたの貢献は簡単に失敗します。 1週間ほど経っても、まだ誰からも連絡がない場合は、もう一度メンテナに聞いてください

ドキュメントは、図書館で作業するときに最初に遭遇することが多いため、詳細で明確であることが重要です。

したがって、使用するコードについて混乱している場合、またはソースに飛び込む必要がある場合は、次の人が簡単にコードを使用できるようにしてください。簡単な更新を書いて、それを貢献してください。オープンソースの貢献者になるために私が知っている最も簡単な方法です。

この記事はもともと私のリストの人々に送られました。このようにもっと読むには、ここでサインアップしてください!


  1. Sony VAIO リカバリ ディスクを作成する最も簡単な方法

    多くのユーザーが Sony VAIO ラップトップを購入しましたが、リカバリ CD/DVD ディスクが付属していません。システム クラッシュが心配な場合や、将来システムを修復または再インストールする必要がある場合は、システム バックアップを作成する必要があります。ここでは、チュートリアルに従って、Windows 10/8.1/8/7 用の Sony VAIO リカバリ ディスクを作成することができます。 . 開始前に準備する必要があるもの: 空の CD-R/DVD-R。 (D-RW、DVD+RW、DVD-RW、1X および 2X 速度の DVD-R、または 2 層 DVD+R および DV

  2. URL を使用してポッドキャストを追加する最も簡単な方法

    ポッドキャストは、自分を楽しませるための人気のある方法です。優れたコンテンツを提供し、デバイスを独り占めしないポッドキャスト アプリがたくさんあります。 iPhone をお持ちの場合は、ネイティブの Podcast デバイスで作業できます。 Apple Podcast には、好みに合ったポッドキャストを見つけるのに役立つ推奨事項を提供する参照セクションが付属しています。有名人が公開しているプラ​​イベート ポッドキャストはたくさんありますが、これらはパブリック ポッドキャストでは検索できません。 プライベート Podcast を聴きたい場合は、それを Apple Podcasts アプリに