背景

初自作キーボード
電子工作は少し経験あり

基本的な部分

Boothのページ

たまにみてた（組立時に特別参考にしたことはないけど）
https://25keys.booth.pm/items/1076720

Zincの公式ページ

基本的にこのビルドガイドをもとに作ったが、大まかな段取りしか書いていないので、初心者はいろいろ他のサイトを参考にする必要があると思う。
http://www.sho-k.co.uk/tech/735.html

組み立て周り

自作キーボードキット Zinc を組んだ

製作工程の写真を多数上げてくれていて助かった
https://hdbx.hateblo.jp/entry/zinc#%E5%AE%8C%E6%88%90

書き込み周り

QMK公式

QMK ToolboxのDependenciesを揃えたんだけど、本来ならDocsにあるコマンドを使ったほうが良かったと思う。
Toolboxの方はavc-gccのバージョン指定がないから最新の8.2を取ってきてしまうんだけど、それだと下の書き込み時にWorkaroundを使う必要が出てくるから。
https://github.com/qmk/qmk_toolbox
https://beta.docs.qmk.fm/detailed-guides/getting_started_build_tools

mac でavr-gccのinstallに失敗する(qmk_firmware関連の作業)

avr-gccのinstallがうまくいかなかった時この人を参考にbrew-install avr-gcv@7をやったらXCodeのInstallみたいなサジェスチョンが出てきてそれに従ったらうまくInstallできるようになった(ちょっと詳細を忘れてしまった)
https://qiita.com/tos-miyake/items/164cad6a1a33e4e30bdb

avrdude flashing error on AVR GCC 8.2.0

avr-gcc 8.2にある不具合でFlashする際にaddress out of rangeのエラーになってしまう。ダウングレードするか、ここに書いてあるWork Aroundを使う。
デフォルトのキーマップを最初入れたときはqmk-toolboxを使ってキーマップデータも書き込みも行った。ただ自分でキーマップをカスタマイズしたくなったらこっちの問題は解決する必要がある。
https://github.com/qmk/qmk_firmware/issues/3657

キーマップ周り

組み立て終わって、接続もうまく行ったあと、レイヤーの概念やキーマップがわからず焦った
そもそもさっきまでやってたのがキーマップの書き込みだということさえちゃんと理解していなかった
調べても全然でなくて、結局GithubのZincのところにDefaultのレイアウトがあった。
後にこれをベースにキーマップをカスタマイズした。
https://github.com/qmk/qmk_firmware/blob/master/keyboards/zinc/keymaps/default/readme_jp.md

おまけ

この記事は今回作ったZincで四苦八苦しながら書いた。