openseo-review-web-content

OpenSEO のウェブコンテンツ

ページはどれも、特定の読者に向けたものです。ブログ記事は、読者の SEO に関する知識を深めるべきです。製品ページは、OpenSEO が読者の課題を解決できるかどうか判断する助けになるべきです。すべての編集を、次のひとつの問いに照らして判断してください。これは読者にとってより良い内容でしょうか？レビューに合格するために書いているのではありません。

読者のために書く

• 読者が何を得られるのかを、読者にとってわかりやすい言葉で冒頭に伝えます。
• 元の資料ではなく、読者の目的に沿って構成します。インタビューは、引用の寄せ集めではなく、計画にまとめます。
• 実際の数値を使い、ひとつの具体例を最後まで取り上げます。
• 内容の詰まった段落よりリストを使います。読者が実行または確認する必要があることには箇条書きを、順番に行う手順には番号付きリストを使います。
• 正式なルールに従うより複雑な場合でも、実践的なアドバイスを示します。
• 回りくどく答えず、率直に答えます。「いいえ」や「費用がかかります」だけで十分な回答です。

読者に関係のないものは削る

• 原稿を確認する人向けの注記：手法に関する注釈、「逐語的」であることの保証、ツール名や API 名、「再確認日」。
• 書き手を守るための曖昧な表現や、読者の注意をそらすリンクや補足。
• 広告のように読めるもの。企業を例として挙げるのは、読者に伝えるためです。

作り話をしない

正確さの基準はそれだけです。製品の機能、価格、引用、データはすべて実際のものでなければなりません。製品に関する主張はコードと照らし合わせて確認してください。表現の仕方、比喩、意見は書き手に任されています。数字ごとに情報開示や出典を求めないでください。OpenSEO を単に「無料」と表現してはいけません。

文体

AI 特有の表現を見つけるには、deslop skill を使います。他の人の記事を編集するときは、その人の文体や例を維持してください。プレイブックライブラリでは、アプローチを「strategy」と呼び、「play」とは呼びません。

変更したファイルには prettier を実行してください。