chirimen-drivers

開発環境のセットアップ

コードの変更を行う前に、以下の手順で環境を整えます。

必要なツール

初期セットアップ

  1. フォーク: chirimen-drivers リポジトリ の右上「Fork」ボタンで、自分のアカウントにコピーを作成
  2. クローン: フォークしたリポジトリをローカルに取得
git clone https://github.com/YOUR_USERNAME/chirimen-drivers.git
cd chirimen-drivers
  1. 依存関係のインストール: ルートディレクトリで実行(すべての workspace パッケージが対象)
npm ci
  1. upstream の追加(推奨): 本家リポジトリの最新変更を取り込むため
git remote add upstream https://github.com/chirimen-oh/chirimen-drivers.git
git remote -v

共通の Git ワークフロー

ドキュメント修正・ドライバ修正・新規追加など、コード変更の PR はすべて以下の流れに従います。

1. 最新の master を取得してブランチを作成

git checkout master
git pull upstream master   # upstream を追加している場合
# git pull origin master   # upstream を追加していない場合
git checkout -b type/short-description

ブランチ名の例:

変更内容 ブランチ名の例
README の誤字修正 docs/fix-readme-typo
新ドライバ追加 feat/example-sensor
既存ドライバのバグ修正 fix/adt7410-temperature

2. 変更を加えてコミット

git add <変更したファイル>
git commit -m "type: short description"

コミットメッセージの形式(Conventional Commits):

プレフィックス 用途
feat: 新機能・新ドライバ追加 feat: add example-sensor driver
fix: バグ修正 fix(adt7410): fix negative temperature calculation
docs: ドキュメントのみの変更 docs: fix typo in README
refactor: 動作を変えないコード整理 refactor(bme280): simplify init logic

3. フォークにプッシュして PR を作成

git push origin type/short-description

GitHub でフォークを開き、「Compare & pull request」から PR を作成します。タイトルと説明に変更内容・動作確認結果を記載してください。

← 目次に戻る