Windows上でNode.jsプロダクトをビルドしてプルリクしてGROWIのdocにcontributeする中継をした。

基本的には流れの通り
- 改行の扱いのみ、個人的には Checkout as-is, commit as-is を指定している
  - チェックアウトする際も、コミットする際も改行コードを保持するということ
  - 新規ファイルを作成する際は、Visual Studio Codeの設定に従われ、そのままの状態となる。必要に応じて変更すること。
  - Linux用のリソースしか扱わないという方は Checkout as-is, commit Unix-style line endings にするとトラブルが無くなるかもしれない

OSSを動かす

git clone git@github.com:weseek/growi-docs.git
公式READMEより https://github.com/weseek/growi-docs
- yarn
- yarn start
  - しかしコマンドが無いと怒られる
yarnが無いのでインストール
- 公式サイトの手順 https://yarnpkg.com/lang/ja/ と言いたいところだが、若干ズルをして・・・
- npm install -g yarn
ビルド、確認
- yarn
- yarn start

https://github.com/weseek/growi-docs にアクセスして、「Fork」をクリック
- Fork中のフォークアイコンかわいい
Fork後、自アカウントにgrowi-docsができるので、そちらをクローンする
- kitkatayamaの場合: https://github.com/kitkatayama/growi-docs
  - フォークしたものでも、リポジトリ名は、リポジトリ設定から変更することができる
先ほどビルドした公式リポジトリからのcloneはフォルダごと削除する
- gitからcloneした内容や、Node.jsが実行した結果はフォルダ内に閉じているので便利
git clone git@github.com:<アカウント名>/growi-docs.git
- kitkatayamaの場合: git clone git@github.com:kitkatayama/growi-docs.git
Visual Studio Codeでcloneしたディレクトリを開く
コンソールを開き、ビルド確認
- yarn
- yarn start
  - 問題が無ければそのままビルドできる
https://localhost:8080/ にアクセス
- Visual Studio Codeのコンソールに表示されているURLはCtrlを押しながらクリックで開くことができる

本家masterと差分を作るため、ブランチを作成する
- git checkout -b "ブランチ名"
  - ブランチ名に命名ルールはないが、一目で何を行ったかわかるようなブランチ名にするようにしている
  - issueを発行している場合、＃番号を含めておくことで連携することができる
ファイルを修正、動作確認
- yarn start している状態でファイルを変更すると、即座にビルドされ https://localhost:8080/ にも変更が反映される
- 望んだとおりの変更となっているか確認する
  - Visual Studio Code上でもMarkdownをプレビューすることはできるが、微妙にレイアウトや構文解析のロジックが違う可能性があるので、必ずビルドを通して確認する
コミットする
- git add ..., git commit ... してもいいが、せっかくなのでIDEの力を借りる
- Visual Studio Code上でソース管理を開く
  - "+"ボタンでadd
  - コメント欄にコメントを記入
    - なるべく簡単な英語で、ブランチの変更内容をコメントする
  - "✓"ボタンでコミット