プロのように GitLab を検索する

GitLab や Web の検索を通常より速くするコツがいくつかあります。 このページでは、それらのコツのいくつかを紹介します。

Glean を使った検索

すべての GitLab チームメンバーは、人、ドキュメント、Issue、チケット、社内ツール全体の会話を 1 か所で見つけるために使う、GitLab の AI ナレッジプラットフォームである Glean にアクセスできます。

Glean を使うとき:

• 複数のシステムを横断して検索する必要がある場合（公開および内部ハンドブック + Slack + Google Drive + Salesforce + GitLab.com）
• 自然言語で質問したい場合: 「経費はどうやって提出する？」や「顧客のエスカレーションは誰が対応している？」
• 複数のシステムに散らばっている顧客情報、ミーティングメモ、ドキュメントを探している場合

app.glean.com にアクセスするか、Okta 経由でアクセスして検索します。Glean は既存のパーミッションを尊重します。あなたがアクセスを許可されている情報のみが見えます。フィルターを使ってソースで結果を絞り込んだり（ハンドブックのみ、Slack のみなど）、一度にすべてを検索したりできます。

GitLab での Glean の使い方の詳細は、ハンドブックの Glean ガイド を参照してください。

Anthropic の Claude を使ったハンドブック検索

Anthropic とのエンタープライズ契約の一環として、すべての GitLab チームメンバーは Claude.ai を利用できます。

Claude の Web 検索機能を活用すれば、この強力なツールを使って GitLab ハンドブック内の情報を検索したり、ハンドブックのガイダンスに基づいてさまざまなトピックについて助言を得たりできます。ハンドブックで参照可能なコンテンツを見つけて解釈する助けになります。

「GitLab ハンドブックに基づき、〇〇について教えて」のようなシンプルなプロンプトは、求めている情報を見つける良い方法です。

site: を使った検索

多くの検索エンジンでは、特定のウェブサイトのみを検索できます。 これを行うには、site: の後に検索したい特定のウェブサイトを続け、その後に検索クエリを入力します。 site: は Google, Bing, DuckDuckGo など、多くの検索エンジンでサポートされています。

たとえば、GitLab ハンドブックで iteration を検索するには次のように入力します。

site:handbook.gitlab.com iteration

または、GitLab ドキュメントで permissions を検索するには次のとおりです。

site:docs.gitlab.com permissions

キーワード検索を使う

site: のテクニックは強力ですが、頻繁に使うと毎回 URL を打つことになり、あまり効率的ではありません。

キーワード検索を使うと、キーワードで特定のウェブサイトを検索でき、ウェブ全般を検索する非常に高速な方法です。

たとえば、GitLab ハンドブックで iteration を検索するには、ブラウザで次のように入力できます（hb は handbook の意味）。

hb iteration

または、GitLab ドキュメントで permissions を検索するには、ブラウザで次のように入力できます（gd は GitLab docs の意味）。

gd permissions

Chrome と Firefox でのキーワード検索の設定手順は以下で確認できます。

Chrome でのキーワード検索の設定

キーワード検索は、Chrome の 検索エンジン 設定で新しい Site searches として作成します。デフォルトでは、Chrome のオムニボックス（アドレスバー）にキーワードを入力し、space または tab をタップしてからクエリを入力して return を押すと、このキーワード検索が使われます。

以下の手順は、GitLab ドキュメントを検索するキーワード検索を設定する方法です。

手順	画像
1. Chrome のアドレスバーを右クリックして Manage Search Engines... を選択
2. Site search セクションで Add ボタンをクリック
3. 新しい Add search engine ダイアログで以下を入力し Add をクリック: a. Search Engine に GitLab documentation b. Shortcut に gd c. URL に https://docs.gitlab.com/search/?q=%s

これをテストするには、新しいタブを開いてアドレスバーに gd Tab merge requests と入力して Enter キーを押します。 GitLab ドキュメントページが開き、merge requests の検索結果が表示されるはずです。

Firefox でのキーワード検索の設定

キーワード検索は、Firefox では新しいブックマークとして作成します。 以下の手順は、GitLab ドキュメントを検索するキーワード検索を設定する方法です。

手順	画像
1. メニューバーの Bookmarks をクリックし、Show All Bookmarks をクリック
2. 左側の Bookmarks Menu を選択
3. 歯車アイコンをクリックして New Bookmark... を選択
4. 新しいポップアップダイアログで以下を入力し Add をクリック: a. Name に Search GitLab documentation b. Location に https://docs.gitlab.com/search/?q=%s c. Keyword に hb

これをテストするには、新しいタブを開いてアドレスバーに gd merge requests と入力して Enter キーを押します。 GitLab ドキュメントの検索結果ページが開き、merge requests の検索結果が表示されるはずです。

Firefox でのキーワード検索のインポート

Firefox ではキーワード検索がブックマークとして保存されるため、インポートが可能です。 以下の手順は、後述の § キーワード検索 URL の例 のキーワード検索をインポートする方法です。

手順	画像
1. キーワード検索 Firefox ブックマークファイル をダウンロード
2. Bookmarks ウィンドウに移動し、インポート・エクスポートアイコンをクリックして Import Bookmarks from HTML... をクリック
3. 新しいポップアップダイアログで、手順 1 でダウンロードしたファイルを選択して、キーワード検索を Firefox のブックマークにインポート

これをテストするには、新しいタブを開いてアドレスバーに gd merge requests と入力して Enter キーを押します。 GitLab ドキュメントの検索結果ページが開き、merge requests の検索結果が表示されるはずです。

キーワード検索 URL の例

次の表は、ブラウザで設定できるキーワード検索 URL の例です。 Chrome と Firefox にキーワード検索を追加する手順は上記にあります。

キーワード検索 URL では、検索クエリが入る位置を示すために URL に %s が含まれています。

通常、キーワード検索 URL に使う URL は次の方法で見つけられます。

1. ウェブサイトで asdf を検索する
2. 検索結果ページがロードされたら、アドレスバーの URL で asdf を探す
3. URL に asdf が含まれていれば、これを %s に置き換えるとキーワード検索 URL に使える URL になる

Firefox で追加の検索エンジンを使った検索

キーワードを使う代わりにアドレスバーで検索エンジンを選択して検索したい場合は、以下の手順で Firefox にカスタム検索エンジンを追加して GitLab を検索できます。

手順	画像
1. Add custom search engine 拡張機能 をインストール
2. インストール後、ツールバーのアドオンアイコンをクリックするか、アドオンマネージャーから「Preferences」をクリック
3. 以下を入力し Add custom search engine をクリック: a. Name に GitLab handbook b. Search URL に https://handbook.gitlab.com/?search=%s c. Icon に https://about.gitlab.com/ico/favicon.ico

これをテストするには、新しいタブに移動してアドレスバーにテキストを入力します。サジェストリストの一番下に新しい検索エンジンのアイコンが表示されるはずです。

Alfred (MacOS) を使った検索

Alfred でキーワード検索を作成できます。 以下の各 URL をクリックすると Alfred に追加できます。

Alfred にキーワード検索を追加するリンク

• gl
• gd
• gg
• mr
• author
• issue

GitLab の favicon を Alfred のカスタム検索にドラッグ＆ドロップして favicon を追加できます。

GitLab チームメンバーの Simon M. が、Alfred と Firefox を使って GitLab をプロのように検索するプロセスを解説する以下の動画も録画しています。

GitLab 関連のワークフローを集めた GitLab チームメンバーが維持するリポジトリ もあります。

Raycast (MacOS) を使った検索

Raycast で、quicklink 機能を使って Spotlight ライクな検索を実行できます。

1. Raycast のホットキーを押す（デフォルト: option + space）
2. ストアを開く（store と入力）
3. GitLab Docs をインストール
4. （オプション）ショートカットを設定する
   1. extensions を検索
   2. Enter キーを押す
   3. GitLab Docs を探す
   4. Alias または Hotkey を割り当てる

これで Raycast を使って検索できます。

1. Raycast のホットキーを押す
2. GitLab Docs、GitLab Handbook、または Pajamas と入力
3. Enter キーを押す
4. 検索クエリを入力
5. Enter キーを押す

選択したブラウザで検索が開きます。

GitLab Unfiltered を使った録画イベントの検索

YouTube チャンネルの GitLab Unfiltered で録画イベントを検索する手順は次のとおりです。

• GitLab Unfiltered を開く
• トップバーの「Search」を示す虫眼鏡アイコンをクリックする
• 録画を探したいイベントを入力する（例: AMA、Group Conversation、Product Kickoff Review、Key Reviews など）
• 検索ページをスクロールして録画動画を見つける
• 「Videos」タブをクリックすることもできる
• 「Date Added (newest)」または「Date Added (oldest)」で並べ替える
• 必要な録画を見つける
• 部門、チーム、トピック別に整理された「Playlists」にグルーピングされた録画を検索することもできる

Git history と Git blame を使った変更の検索

上記の GitLab Unfiltered 動画で、Darren M. が Git ファイルヒストリーと Git blame を使ってハンドブックの変更を追跡する短いチュートリアルを解説しています。

GitLab のリポジトリで Git ファイルヒストリー と Git blame を使って変更を検索できます。

Git ファイルヒストリーはファイルに関連するコミット履歴の情報を提供し、blame はファイル内の各行について最終変更時刻、作者、コミットハッシュなど、より多くの情報を提供します。

これは「GitLab はいつ BlueJeans から Zoom に切り替えた？」のような質問に答えるのに便利です（答えは 2016-09-22 の このコミット にあり、これらの用語を参照する元のハンドブック変更が示されています）。

検索を開始する場所の参考として、GitLab のウェブサイト/ハンドブックは www-gitlab-com リポジトリ にホストされており、GitLab ドキュメントは こちら にあります。

GitLab 検索バーを使った GitLab のナビゲーション

GitLab には、検索バーに入力するとさまざまなページへのオートコンプリートナビゲーションを得られる、ハードコードされたショートカットがいくつかあります。この検索バーを使って、プロジェクトやグループ間を移動することもできます。

GitLab チームメンバーの Dylan が、その仕組みを示す以下の動画を録画しています。

ページのソースコードを見る - ページの編集 - please contribute.