こんにちは、masatomo です。組み込みエンジニアとして働きながら、個人で Web サービスを作り、学んだことを Qiita の連載にしています。今回は、その連載の1本に読者からコメントをもらって、自分の書き方を見直した話です。 ■ 何があったか HTML と CSS の入門連載の第6回で、「CSS の色の書き方は2つあります」と書きました。公開してしばらくして、読者の方から「色の書き方はもっとある」という趣旨のコメントをいただきました。 ■ 調べて分かったこと MDN の資料で確かめると、たしかにその通りでした。16進数の書き方は3桁・4桁・6桁・8桁があり(4桁と8桁は透明度つきです)、そのほかに rgb() や hsl() などの関数の書き方、currentColor のようなキーワードもあります。連載で使うのは最初の2つですが、「2つしかない」と読める書き方になっていました。 ■ 直したこと 記事の該当箇所を「いくつかの書き方があり、この連載では最初の2つを使います」という内容に直し、MDN へのリンクを足しました。記事の末尾には、コメントを受けて直したことも書きました。コメントをくださった方には、言い過ぎだったことと、直した内容を返信しました。
■ 個人開発でも同じことをしています
この連載は、音楽交流アプリ OTOMO、記事サイトの DTM PICKS と DTM DIGS を作って運用するなかで学んだことが元になっています。コードの多くは AI(Claude Code)に書いてもらっているので、動いて見えても、中身を自分で確かめる習慣が大事だと感じています。たとえば OTOMO の退会処理では、プロフィール画像の削除に失敗したときに処理が先へ進んでしまわないか、コードと公開済みの関数の両方を見て、失敗したら止まる作りになっていることを確かめました。記事も個人開発も、「たぶん大丈夫」で出さず、確かめてから言い切る、という点は同じです。 ■ 考えたこと 入門記事では、話をしぼるために「〜は2つです」と言い切りたくなります。でも、読む人は「それ以外はない」と受け取ります。自分の知らないことは、知らないままでも書けてしまうので、「これは連載で扱う範囲」と「全部」を分けて書くよう気をつけます。指摘を受けて直す流れも、記事の一部として残すことにしました。 連載はこちらで公開しています。https://qiita.com/masatomoto-cmyk