'LISTEN)【sIFR】...でletter-spacingを効かせる方法。shuffleが終了しました。コメント記述位置コメントの記述位置について以下のようなエントリーを目にしましたが、目から鱗です。いうか、未熟にも今まで気づきませんでした。-->こうじゃなくて、こうしてほしい。操作する時に、決定的な違いが出てきますよね。悪いコメントの記述位置たとえば、以下のようなコードを書いたとします。見ての通り、コメントは、対象となる要素の外(ここでは前)に記述されています。要素の位置を入れ替えることになったとします。何でもいいですが、とにかく、このまま実行すると、以下のようにコメントと構造のセマンティクスが対応しなくなってしまいます。contents"><h2>本編の見出し</h2></div>プログラマーやエンジニアからしてみたら、確かにこれはイライラの元になるでしょうね。文書構造を操作するたびに、内部構造とコメントのミスマッチが生まれる可能性におびえなくてはならないわけですから。(プログラマーかデザイナーかに関わらず、意味不明なコメントほど、ソースコードを見る者を困惑させるものはありませんし。)良いコメントの記述位置そこで次のように、コメントを、コメント対象となる要素の中に記述します。することで、後になって構造を操作しても、コメントと構造の関係が対応したまま保持されます。--><h2>本編の見出し</h2></div>これは個人的にとても勉強になりました。平気で書いてましたから..。引用:このあたりは、多少、好みが入りうる余地がある部分なので、絶対こうすべきだ!というルールはないんですが、個人的に若干異論があったので、蛇足かもしれませんが書き留めておきます。対応する始点をいちいち遡って確認し直すのに余計なひと手間が掛かりますし、メモ帳やテキストエディットのような構造をパースできないエディタを使っている場合、目視によって構造を判断することになるので、始点の位置を間違えるリスクが生じるからです。さんに言ってもしょうがない話になってしまうかもしれませんが、始点はともかく、なぜ終点にコメントをつける必要があるのか、イマイチ僕には分かりません。終点を(もしくは始点と終点の両方を)記述するのに意味があるケースがあるとすれば、それはマークアップすることでツリー構造が崩れてしまうようなケースくらいでしょうか。本で例えれば、本の論理的な構造(章・節など)と、媒体や組版上の構造(行やページなど)を同時にマークアップしようとすると、1ページ内に前節と後節の内容がまたがってしまったりして、ツリー構造が崩れてしまう..とか。要素があるのはこのため。相当する要素は残念ながらありませんけど。内容)</div>(この場合(本のページ数とセクション数の場合)は、始点か終点のどちらか一方のみの記述でもOK。ような形でマークアップしてしまうと、ツリー構造が崩れてしまう。)もっとも、コメントの記述位置同様、単に僕が気づいてない|知らないだけなのかもしれないので、もしこれという理由がある方は、一見些末に思えるようなことでも結構ですので、是非是非、お教えくださいませ。本節の最初にも言ったように、このあたりは好みが入りうる余地がある部分で、要するに重要なのは、制作チームが内部的にコーディングルールを共有することという部分になるのかな..と。さんの想定されていたコメントのユースケースを取り違ってしまったようです。ついている要素の始点・終点の頭出し用コメントでした。開始位置と終了位置を簡単に頭出しできますよね。普通に文字列検索をかければいいだけなので、エディタにパース機能がついている必要もありませんし。さんの意図していたところとは、ポイントが少しズレている点をご了承おきくださいませ。--></div>のようなケースですね。さんが意識されていたコメントのユースケースを完全に取り違ってましたね、僕。abstract">終了タグは(↓のように)パッと見て分かりません。</div>どちらが要らないかというと、開始タグのコメントかなーと。どちらも無いなら無いでいいんですが。コード共有のためのネーミングルール。