CSS プロパティの記事の作成方法

まず、どのプロパティを文書化するかを決定する必要があります。ページが欠けていることに気づいたり、問題リストで報告されているコンテンツの欠落を見たことがあるかもしれません。 CSS プロパティの詳細については、その関連する仕様（たとえば W3C 仕様 や、Gecko や Blink などのレンダリングエンジンで使われている非標準のプロパティに関するバグレポート）を見つける必要があります。

実装と仕様が乖離している場合、遠慮なく実装のバグに言及してください。以下のようなことが起きている可能性があります。

• 実装にバグがある（そしてバグのフォローアップが登録されている）可能性があります。
• 新しい仕様の発行が遅れていることが原因である可能性があります。
• 仕様の誤りである可能性があります（この場合、仕様のバグを提出する価値があります）。

CSS プロパティのいくつかの特徴、例えばその構文やアニメーションが可能かどうかなどは、いくつかのページで言及されているため、アドホックデータベースに格納されています。ページで使用するマクロは、そこに保存されているプロパティに関する情報を必要とするので、まずこの情報があるかどうか確認することから始めてください。

準備完了です。では、実際に CSS プロパティページを追加してみましょう。新しい CSS プロパティページを作成する最も簡単な方法は、既存のページの内容をコピーして、新しいプロパティに合うように編集することです。新しいページを追加する方法は、新しいページの作成方法に記載されています。

リファレンスページを作成する際、例を追加したいと思うでしょう。そのためには、このライブサンプルについてのチュートリアルに従ってください。私たちは 1 つのプロパティを説明する文書にいることを忘れないでください。仕様全体がどのように使用されるかではなく、このプロパティが単独でどのように動作するかを示す例を追加する必要があります。つまり、list-style-type の例では、様々なプロパティ値が何を生成するかを示すべきで、他のプロパティ、擬似クラス、擬似要素と組み合わせて、どのように素晴らしい効果を生成するかを示すべきではありません。より多くのことを示すには、チュートリアルやガイドで書いてください。

ページ作成後、プルリクエストとして提出すると、当社の審査担当者が自動的に割り当てられ、ページをレビューします。