エージェント向け Polysh を早期アクセスで提供中。コーディングエージェントがデモを録画し、Polysh が仕上げます。 ウェイティングリストに登録 →

ドキュメント読みやすさチェッカー

セクションごとに、Flesch Reading Ease のスコアと学年レベルがわかります。

このツールは英語のテキストを分析します。

ブラウザツールを読み込んでいます…

ドキュメント読みやすさチェッカーでできること

読みやすさの公式は、文の長さと単語の長さをスコアに変換します。ヘルプ記事、SOP、ドキュメントのページを貼り付けると、テキスト全体と、見出しの下の各セクションについて、Flesch Reading Ease(高いほど易しい)と Flesch-Kincaid の学年レベル(低いほど易しい)がわかります。

長い文書で特に役立つのがセクションの表です。密度の高い Architecture のセクションが 1 つあるだけで、親しみやすいガイド全体が難しい範囲に引き下げられることがあり、スコアが 50 未満のセクションは太字で示されます。コードブロックと見出しは除くので、サンプルの多いページが不利になることはありません。上限(既定は 25 語)を超える文は、専用のタイルで数えます。

例

入力

## Quick start
Open the app. Click New video. Pick a recording from your library.

## How rendering works
The renderer combines your recording, the generated voiceover, and the caption track into a single file. Larger projects take longer because every frame is processed again.

結果

Reading ease: 52.2 (fairly difficult)
Grade level: 7.9
Quick start: ease 69, grade 4.7
How rendering works: ease 41, grade 10.8

短い文の Quick start は読みやすく、2 つ目のセクションの長い単語が全体のスコアを 60 未満に下げています。

ドキュメント読みやすさチェッカーの使い方

  1. 文書を見出しごと貼り付けるか、「例を使う」を押します。
  2. 「指摘する文の長さ」を、スタイルガイドで認められている最長の文に設定します。
  3. 「セクション」「読みやすさ」「学年」「単語数」の表で、太字の行から見直しを始めます。

知っておきたいこと

  • 音節数はルールと例外リストで推定するので、製品名や専門用語によってスコアが数ポイント上下することがあります。
  • とても短いセクションではスコアが安定しません。2 文しかないセクションでは、長い単語が 1 つあるだけで大きく動きます。100 語以上のセクションで判断してください。
  • 密度の高い技術文書ではスコアが 0 を下回ることがあります。これは Flesch の公式の仕組みによるもので、エラーではありません。
  • 読みやすさのスコアが測るのは文と単語の長さで、わかりやすさではありません。あいまいな語や複数の操作を含むステップを見つけるには、手順の複雑さチェッカーを使ってください。

ドキュメント読みやすさチェッカーについてよくある質問

Flesch Reading Ease のよいスコアはどれくらいですか?

60〜70 は、ほとんどの大人が楽に読める平易な英語で、ヘルプコンテンツのよい目標です。70 以上は易しい文章です。50 未満はやや難しく、30 未満は学術的な文章のように読めます。技術ドキュメントは 40 台から 50 台になることがよくあります。

ドキュメントはどの学年レベルで書くべきですか?

ヘルプセンター、オンボーディング、SOP では、学年 8 以下を目指してください。開発者向けドキュメントは専門用語のため学年 9〜12 になることが多いですが、それでも文を短くすれば、英語が母語でない読み手の助けになります。

Flesch-Kincaid の学年レベルはどのように計算しますか?

1 文あたりの平均単語数に 0.39 を掛け、1 単語あたりの平均音節数に 11.8 を掛けたものを足し、15.59 を引きます。Reading Ease は同じ 2 つの値を別の重みで使います。文を短くしても、単語を短くしても、スコアは改善します。

SOP を読みやすくするには?

ステップは 1 つの操作にとどめ、それぞれ動詞で始め、チームが実際に使っている言葉を使い、背景は別のセクションに移してください。ここでスコアを確認し、読みやすさが最も低いセクションから見直します。