最近知ったIncomplete List of Mistakes in the Design of CSSというページが気に入りました。CSSを書かない人にはあまりピンとこないかもしれませんが、書く人ならのぞいてみると面白いと思います。印象的な引用をいくつか紹介します。

• border-radiusはcorner-radiusであるべきだった。
• !importantとすべきではなかった — エンジニアには「not important（重要ではない）」と読めてしまう。別の書き方を選ぶべきだった。
• white-space: nowrapはwhite-space: no-wrapであるべきだった。

似たようなリストであるKnown Anomalies in Unicode Character Namesを思い出しました。例を一つ挙げます。

U+02C7 CARON
U+030C COMBINING CARON

「caron」はhacekおよびcombining hacekと呼ばれるべきだった。「caron」という用語は初期の標準化団体による造語だと疑う向きもあるが、デジタルタイポグラフィ以前からLinotype社で使われていたという主張もある。その真の起源は時の霧の中に失われたのかもしれない。

これらのリストが素晴らしいのは、単純に「ここで私たちは間違えた」と認めている点です。簡潔で、問題に対して率直です。もちろん、この段階ではまだやるべきことはたくさんあります。CSSのリストは今のところ「単純な」低レベルの指摘しか含んでいませんし、CSSもUnicodeも既存の挙動に依存している人やシステムがいるため、簡単に修正できるわけではないと思います。しかし、まずは問題があると認めることが第一歩ですよね。

外側にいる人にとっては、「なんだ、自分だけじゃなかったんだ、他の人もこれが好きじゃなかったんだ」と気づくことで安心できるものです。（他のユーザーのバグ報告に目を通すのも、同じように役立つことがあります。）内側にいる人なら、長く続いているプロジェクトでこのようなリストを作ってみることを考えてみてください。あなたやチームのためになるかもしれません。

もしこのような文書を他にもご存じでしたら、ぜひ教えてください。