# 効率的な社内知識の調べ方

ウォンテッドリーには大量の社内ドメイン知識が存在します。 それらは業務中頻繁に遭遇するため、はじめに効率の良いキャッチアップ手順を覚えておくとよいでしょう。

## 3 ステップで調べる

社内で何かを調べる際は以下の 3 ステップで調べましょう

1. [Handbook](https://docs.wantedly.dev/) で調べる
2. [Backstage](https://backstage.internal.wantedly.com) で調べる
3. Slack で聞く・過去の Github Issue/PR で調べる

### 社内向け

現在 Handbook に対する社内フィードバックを積極的に集めています。「欲しい情報が見つからなかった」「知りたいことが知れて便利だった」などは是非[こちらの Discussion (internal) ](https://github.com/wantedly/dev/discussions/1923)にコメントしてください。

## 詳しく

### 重要なことは大体 Handbook に書いてある

Handbook は公開前提で書かれていたり、[元々オンボーディング資料として作られていた](https://docs.wantedly.dev/preface)こともあって社内で一番読みやすいドキュメンテーションになっています。 そのため、New Joiner のオンボーディングや専門外の領域について調べる際はまず初めに Handbook で調べると良いでしょう。 また、検索だけでなく目次をざっと眺めて「こういう概念あるんだ〜」のインデックスを頭に作っておくことも重要です。

![検索窓の場所の画像](/files/Y1jbeSfbgwP4UymaNvB7)

ただし特定のチームやマイクロサービスに紐づく詳細情報は Handbook ではなく、個々のリポジトリに記載する運用なので、それらは後述の Backstage を用いて検索してください。

### 詳細情報は BackStage で調べる

Backstage は複数の Github リポジトリに存在するマークダウンファイルを横断的に検索できるツールです。

![Backstage で検索したときの png](/files/G0FiQZNpwqQltXTlTJJA)

Backstage には大量のドキュメンテーションが保存されています。そのため、検索キーワードさえ知っていれば簡単に目当ての情報を得ることが可能です。

一方で、ページ数が多すぎるがゆえ明確な検索キーワードを持っていないと非常に扱いづらいです。 New Joiner や専門外の領域について調べる際は、まずは Handbook で全体像を掴んだ上で個別のトピックを Backstage で検索すると良いでしょう。

### それでも分からなければ Slack で聞く、過去 Issue を調べる

Handbook や Backstage を利用すればほとんどの調べ物は行えますが、時には目当ての情報にたどり着けないこともあります。 そんなときは Slack で質問をしたり、過去の Issue/PR を探すことで欲しい情報を探しましょう。

![Slack で検索したときの png](/files/H6kZtVrS5KgsN5dkqYuZ)

ただし、次回以降も違う人が Slack で質問したり、過去 Issue/PR を探したりするのは非効率です。 ドキュメンテーション化されていなくて困った情報は積極的に PR を作成しましょう。

#### 話を聞きに行きたい

* Slack: [#devops\_guild](https://wantedly.slack.com/archives/C04P8GL7ZPS)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wantedly.dev/introduction/catching-up-on-in-house-knowledge.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.