オンボーディングファイル作成のススメ

# ISSUEに移動しました。
関連情報を発信していますのでご購読お願いします。

https://i-ssue.com/topics/ef97f480-e831-428e-bfab-f70faae4cc04

皆さんは、新しい会社で開発を始めた時開発環境の構築に時間がかかってうまくスタートをきれなかったり、
他の人がうまくスタートをきれなかった人をみたことはありませんか。

私は、あります。
私自身、掛け持ちで仕事をしていて新しく副業で入った企業先でgithubに招待してもらってその後何も作業せず地蔵状態になったことがあります。(これはちょっと極端ですが)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/124461/158e8033-92e9-b3e9-e0db-d35d4dbe57a3.png)


別の時には同時期に入ったエンジニアが途中で離脱してしまうケースもありました。
これらの原因は開発参加初期に受け入れ体制が整っていないことが原因です。

特にリモートで副業するエンジニアにとっては、
ちょっとでも壁があるとすぐに離脱してしまいます。


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/124461/bb780d89-90b2-b66d-14c4-b3757ba33d6a.png)


しっかりメンター的な立場の人がいれば問題ありませんが、
スタートアップにはそこまでリソースをさく余裕はありません。(スタートアップ以外も)

そこで、オンボーディングファイルを作り受け入れを半自動化することでこの問題を解決しましょう。というお話をします。


## オンボーディングファイルとは新しく参加してきた人が1prを作ってmergeできるようにするためのもの

dockerコマンド打って、localhostを立ち上げるだけでなく、サービスの構成やビジネスドメイン、サービスウォークスルーの動画まで用意します。
このサービスはなぜ世の中に必要で、業界はどこで、登場人物は誰かまで把握できます。システムだけじゃなく、システムを利用する顧客の顔・声まで理解するとエンジニアのパフォーマンスは高くなります(多分)

以下はオンボーディングファイルのサンプルです。

■ トップ
![スクリーンショット 2021-10-05 0.46.17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/124461/65c9376d-9aeb-b6e2-c799-13711be8f7d4.png)

■ サービス構成について
![スクリーンショット 2021-10-05 23.52.21.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2115497/81943a49-22e1-02a6-8712-8c7f3df511b2.png)

■ ウォークスルー
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/124461/8e84373f-31ed-6930-9997-873dc438af7b.png)

[サンプルはこちら](https://innovative-turret-f2e.notion.site/dbedffb26f8d42979d75000c5cd3e523)



## なぜオンボーディングファイルを作ろうと思ったか？

自分で立ち上げたサービスの初期のコンセプトがissue単位で仕事ができることだったのですが、
受け入れ体制が整っていないとイニシャルコストが高いのでコスパが悪くなると言われその対策として用意したのがきっかけです。

## 実際に使ってもらった人の声

実際に[ISSUE](https://i-ssue.com/)を導入いただいてる企業様にはオンボーディングファイルを作成させていただいており、
ISSUE経由で参加しているエンジニアさんに使ってもらってます。
![スクリーンショット 2021-10-05 0.35.50.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/124461/18565c67-c2dd-80b2-5871-7a790af134ff.png)



## オンボーディングファイルを導入するメリット1: 受け入れコストが下がる

こちらはいうまでもないですが、
情報を集約することによって新しく入った人が自ら作業を行える状態になります。


## オンボーディングファイルを導入するメリット2: オンボーディングファイルを渡して、質問数や環境構築の時間を他の人と比較し、能力を図ることができる

オンボーディングファイルには環境構築や開発に参加するための情報が揃っています。
それにも関わらず、ファイルに書いてあることを質問してしまうと読解力がなかったり、あまり自分でインプットをせず他者にきいてしまう人ととなります。それはコミュニケーションコストを高めることにつながり、チームのパフォーマンスを落とします。

## おまけ: slack招待時のファーストメッセージもテンプレート化する
slackに入ってきた時点で参加者は何をしていいのかわからないので、
ファーストメッセージもテンプレート化するのがおすすめです。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/124461/f89219af-5db8-56ce-1305-48d2b3edbf9d.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/124461/95ede1db-7f91-2477-a22b-738504f4ee07.png)
https://i-ssue.com/

* [@sagae_kig](https://twitter.com/sagae_kig)で情報発信しています。ぜひフォローお願いします！

# おすすめの記事
[メール返信率を20倍にして時間単価6000円の案件を獲得する方法](https://qiita.com/k_s/items/8d7ce60c10ad16322119)
[業務委託単価診断を作って225名の方に回答してもらったので結果を公開します](https://qiita.com/k_s/items/08a88258fa621dfb7237)
[エンジニアの敵である脂肪を1年で9kg落としたのでそのやり方を書く](https://qiita.com/k_s/items/f7798638463a9d58e325)
[Qiitaを使って2週間で17万人のエンジニアの認知を獲得したので採用に応用してみる](https://qiita.com/k_s/items/03f2d51cb0096535c6f2)
[5,000円/時間以上で働く方法を考えてみた](https://qiita.com/k_s/items/e2208e276bdeb3048f37)
[チーム開発を倍速にする方法6選](https://qiita.com/k_s/items/987791592e1eb93187aa)
[オンボーディングファイル作成のススメ](https://qiita.com/k_s/items/ee9f4f76cbef70098795)
[プロダクトを作ってから登録ユーザー400名、月間売上100万円を達成するまでにエンジニアががむしゃらに行った営業方法のメモ書き](https://qiita.com/k_s/items/e644b71446c3b347a8e1)
[1人で開発したら数ヶ月かかるマッチングサービスを、ローコード・ノーコードで3日で作った(Airtable/Notion/Zapier/Sendgrid/Firebase)](https://qiita.com/k_s/items/f49a24c968f96d34cd94)
[個人のためのコードレビューサービスを開発しました。](https://qiita.com/k_s/items/5ee22a3ef74493958565)
[エンジニア200人に聞いて、業務委託単価表を作りました](https://qiita.com/sagae_twins_developper/items/f6f89820021e7ed0050a)
[業務委託単価表がバズったので、Webエンジニア業務委託の単価診断を作って225名の方に回答していただきました](https://qiita.com/sagae_twins_developper/items/ab21d3660e48a01609e7)
[エンジニアが入りたいスタートアップの特徴](https://qiita.com/sagae_twins_developper/items/6921128867b118d495e3)
[一流のエンジニアになるために一度は読んでおきたい、Google開発者用のコードレビューガイドをすごく簡単に要約してみた。](https://qiita.com/sagae_twins_developper/items/c6faa6029d7335061442)
[エンジニアとして普段よく使うサービスをまとめてみた](https://qiita.com/sagae_twins_developper/items/11338b5b0b565a5deee5)
[できないエンジニアの特徴](https://qiita.com/sagae_twins_developper/items/399c233ea6b00c8f5734)
[リモートエンジニアになって2年弱、実践してよかったメンタルケアを挙げてみた](https://qiita.com/sagae_twins_developper/items/8d92c309e1533b5306c5)
[フリーランスになって1年半経ったので、絶対にやっておくべきことをまとめた](https://qiita.com/sagae_twins_developper/items/9c60182610e736c8777f)
[月間売上100万、ユーザー数が600人を超えたサービスがStripe connectを導入して感じたこと](https://qiita.com/sagae_twins_developper/items/da15cf7315672cc79dcd)