問題
<link rel="import" href="...">のようなタグを使わずに、Polymer.importHrefを使って初期レンダー後にレイジーロードしたり、動的にリソースをインポートするときの話。他人のコードを読んだり、後で保守するときにヘッダー部分をみてもコンポーネントの依存関係がすぐに把握できず地味に困る。
対策
iron-component-pageを使ってドキュメント化してもいいが、面倒なのでパス。そこで以下のようなコーディングルールを使うことにした。
ヘッダー部分
<link rel="import" href="../static-import-element.html">
<!--
Lazy load
<link rel="import" href="../lazy-load-elememt.html">
Dynamic import
<link rel="import" href="../dinamic-import-elememt.html">
-->
これでヘッダーをみるだけですぐに依存関係が把握できる。
ただし、コードとコメントの同期が保たれないリスクが生じるので、インポート側にも変更時にはコメントを書き換えるように念のため注意書きしておく。