Perl バックエンドを持つプロジェクトのフロントエンドに取り組んでいます。CSS ファイルはかなり大きく複雑になりつつあり、いくつかのドキュメントと目次が必要です。
さまざまなガイド、スライド、ブログ記事を見て、誰もが独自のスタイルのプレーン テキスト形式を提案していました。適切な標準がないように思われるため、ドキュメントの移植、印刷、および読み取りが困難になっています。
私たちの他のドキュメントは POD (Plain Old Documentation) / perldoc にあるので、CSS にも POD を使用できると考えましたが、これは非常に型にはまらず、率直に言って少し奇妙に感じます。私は簡単に試しました：
/*
=pod
...
=cut
*/
そしてそれはperldocでうまく読めます。
サイズが問題にならないように、リリース前に CSS ファイルからすべてのコメントを取り除きます。
POD を使用して CSS を文書化することについて、他に実際的な反論はありますか? CSS を文書化するために他の標準を使用しましたか?