私が初心者のオープンソース コントリビューターだったとき、最大の課題の 1 つは、取り組むべき適切なプロジェクト/問題を見つけることでした。
私は長い間、インターネット上のさまざまなライターのリソースに依存していました (ちなみに、これらは素晴らしいものです)。しかし、私は常にこの問題の解決策、つまり自分のスキルセットに合ったプロジェクトを検索して追跡できる方法を見つけたいと考えていました。
1 つ同意しましょう。Google とは異なり、GitHub を検索するのは簡単ではありません。しかし、開発者としては、毎日 GitHub または Gitlab を操作する可能性が高くなります。
ここで問題となるのは、これらのバージョン管理システムを何に使用するかではなく、どのように使用するかです。 Google 検索スキルを習得することが平均的なインターネット ユーザーにとって不可欠であるのと同様に、開発者にとって GitHub を効果的に検索する方法を学ぶことは不可欠であると私は考えています。
この記事では、GitHub を適切に検索する方法に関するさまざまなテクニックを説明します。次の検索方法を学びます:
- 問題とプル リクエスト
- リポジトリ
- ユーザー
- トピック
GitHub を使用する際に役立つヒントをいくつか示します。
is:issue is:open label:beginner - この特定のクエリwill 開かれており、初心者の質問としてマークされているすべてのプロジェクトをリストします。
is:issue is:open label:easy - これには、easy としてマークされているすべての未解決の問題がリストされます。
is:issue is:open label:first-timers-only - これには、初めての方も歓迎される未解決の問題がすべてリストされています。
is:issue is:open label:good-first-bug - これは、解決プロジェクトに適しているとマークされた最初のものをリストします。間違った未解決の問題に取り組むよう寄稿者を惹きつけること。
is:issue is:open label:"good first issue" - これにより、「good first issue」というラベルが付いた未解決の問題がすべてリストされます。質問」ということは、初心者が始めるのに適した場所であることを意味します。
is:issue is:open label:starter - starter
question というラベルが付いた未解決の問題をすべてリストします。is:issue is:open label:up-for-grabs - 必要なスキルをお持ちの場合は、未解決の問題をすべてリストします。いつでも処理できます。
no:project type:issue is:open - 特定のプロジェクトに割り当てられていない未解決の問題をすべてリストします。
no:マイルストーン タイプ:問題は:open - 多くの場合、プロジェクトはマイルストーンを使用して追跡されます。ただし、追跡されていない問題を見つけたい場合は、この検索クエリでそれらの項目がリストされます。
no:label type:issue is:open - これにより、ラベルの付いていない未解決の問題がすべてリストされます。
is:issue is:open no:assignee - 誰かに割り当てられていない未解決の問題をすべてリストします。
リポジトリの検索方法
デフォルトでは、検索するには、検索バーにリポジトリ名を入力するだけです。いくつかの検索結果が表示されます。
しかし、希望どおりの買い戻しが得られる可能性は非常に低いです。
検索を絞り込むいくつかの方法を見てみましょう:
名前、説明/README で検索する方法
README の名前と説明で検索する場合の注意点ファイル 重要なのは、検索フレーズが in 修飾子で始まる必要があるということです。これにより、探しているものの「内部」を検索することが可能になります。
例
in:nameを使用します。データ サイエンスについて詳しく学ぶためのリソースを探しているとします。この場合、Data Science in:nameコマンドを使用すると、リポジトリ名に Data Science が含まれるリポジトリが一覧表示されます。in:descriptionを使用します。特定の説明を持つリポジトリを検索したい場合、たとえばリポジトリの説明に「freeCodeCamp」という単語が含まれている場合、検索は次のようになります:freecodecamp in:description##in:readme
を使用します。これを使用して、ファイルの README で特定の語句を検索します。 README に freecodecamp という単語が含まれるリポジトリを見つけたい場合、検索は次のようになります:freecodecamp in:readme.- Use
in:topic
。これを使用して、トピック内で特定の語句または単語がタグ付けされているかどうかを確認します。たとえば、トピックに freecodecamp がリストされているすべてのリポジトリを見つけるには、検索は次のようになります:freecodecamp in:topic
例
stars:n
を使用します。 1000 個のスターを持つリポジトリを検索する場合、検索クエリはstars:1000になります。これにより、1000 個のスターが付いたリポジトリがリストされます。-
forks:n
を使用します。これは、リポジトリに必要なフォークの数を指定します。フォークが 100 個未満のリポジトリを見つけたい場合は、検索は次のようになります:forks:<100。
<、>、<= などの関係演算子はいつでも使用できます。 >= および .. は、検索をさらに絞り込むのに役立ちます。
例:
- 言語:LANGUAGE
を使用します。たとえば、PHP で書かれたリポジトリを見つけたい場合、検索は次のようになります:言語:PHP
org:... に続けて組織名を入力して検索を開始する必要があります。
org:freecodecamp を検索すると、freeCodeCamp に一致するリポジトリが一覧表示されます。
created、更新済み、マージ済み、およびクローズ済み。これらのキーワードは、YYYY-MM-DD の形式で日付とともに使用する必要があります。
例:
- キーワード:YYYY-MM-DD
を使用します。たとえば、2022 年 10 月 1 日以降に作成された freeCodeCamp という単語を含むすべてのリポジトリを検索したいとします。その場合、検索は次のようになります:freecodecamp created:>2022-10-01
<, > # を使用することもできます。 ##、>= および <= を使用して、指定した日付以降、前後の日付を検索します。範囲内で検索するには、.....ライセンスによる検索方法
#を使用して検索できます。プロジェクトにとってライセンスは非常に重要です。ライセンスが異なれば、寄稿者ができることとできないことに対して異なる権利が与えられます。
正しいライセンスを持つプロジェクトを見つけやすくするには、ライセンスについてよく理解する必要があります。詳細については、こちらをご覧ください。
例:
-
license:LICENSE_KEYWORDを使用します。これは、特定のライセンスを持つプロジェクトを検索するのに最適な方法です。たとえば、MIT ライセンスを持つプロジェクトを検索するには、license:MIT.
可視性による検索方法
## を使用します。 ## リポジトリの可視性に基づいて検索することもできます。この場合、パブリックまたはプライベートを使用できます。これにより、パブリックまたはプライベート リポジトリ内の課題と PR がそれぞれ照合されます。例:
- is:public
を使用します。これにより、パブリック リポジトリのリストが表示されます。 freeCodCamp が所有するすべてのパブリック リポジトリを検索する例を見てみましょう。その場合、検索はis:public org:freecodecampになります。 - is:
private を使用します。このクエリは、指定された検索クエリの下にあるすべてのプライベート リポジトリを一覧表示することを目的としています。
GitHub ドキュメント を確認するか、Advanced GitHub Search を使用してください。これらの方法は、より多くのフィルタリング オプションを提供するため、常に便利です。
さまざまな検索パラメーターを使用して、GitHub での日常のアクティビティを簡素化できます。このプラットフォームをより簡単かつ効果的に使用するのに役立つことを願っています。元のアドレス: 翻訳アドレス: