chaffjs 0.16.0 → 0.18.0

package/rules/max-paragraph-length.yaml

@@ -9,8 +9,8 @@ name:
   en: Paragraph too long
 
 why:
-  ja: 1 段落に文を詰めると、読み手はどこで息継ぎしていいか分からなくなります。
-  en: A dense paragraph gives the reader nowhere to pause.
+  ja: 1 段落に文を詰めると、読み手はどこで息継ぎしていいか分からなくなります。短い文をいくつ並べても壁にはならないので、段落が普通の長さの文を上限の数だけ並べたより長いときだけ指摘します。
+  en: A dense paragraph gives the reader nowhere to pause. Short sentences do not make a wall, so it is reported only when it is also longer than that many sentences of ordinary length.
 
 message:
   ja: この段落は {count} 文あります（{limit} 文まで）
@@ -22,6 +22,13 @@ how_to_fix:
 
 levels: { strict: 3, normal: 5, relaxed: 8 }
 
+# 普通の長さの文 1 つの長さ。単位は adapter の lengthUnit（日本語は文字、英語は語）。
+# 文の数が上限を超えても、段落の長さが「上限 × この長さ」以下なら指摘しない。子ども向けの文章のように短い文を重ねた段落は、息継ぎの場所がいくらでもある。
+# corpus で、これより短い段落は短い文の積み重ね（子ども向けの解説、リリースの一覧、Q&A）だけだった。上限と掛けるので、段階・ジャンル・chaff.yaml の数値がそのまま効く。
+full_sentence:
+  ja: 70
+  en: 18
+
 # 条文・判決・論文の段落は、一つの規定や論点をまとめて書く。corpus のその種類の文書で、normal が最も長い一握りの段落だけを指すように測って置いた。
 by_genre:
   legal: { strict: 5, normal: 8, relaxed: 12 }
@@ -30,3 +37,36 @@ by_genre:
   academic: { strict: 5, normal: 9, relaxed: 12 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 文を詰めこみすぎて、息をつく場所がない段落
+  en: A paragraph packed with so many sentences that the reader has nowhere to pause
+example:
+  ja:
+    config: { rules: { max-paragraph-length: strict } }
+    before: |
+      今期の売上は前年より一割増えましたが、その多くは春に新しく始めた定期購入の申し込みによるもので、店頭での買い物が増えたわけではありませんでした。一方で、店頭での販売は三か月続けて前年を下回り、特に平日の夕方の客数が大きく減っています。原因として、駅の反対側に開いた競合店と、夕方の品ぞろえの薄さが考えられるという声が、先月の店長会議で何人もの店長から出ました。来期は夕方の品ぞろえを見直し、定期購入の案内を店頭でも配ることで、両方の数字を同時に上げることを目指します。
+    after: |
+      今期の売上は前年より一割増えました。その多くは、新しく始めた定期購入の申し込みによるものです。
+
+      一方で、店頭での販売は三か月続けて前年を下回りました。特に平日の夕方の客数が大きく減っています。
+
+      来期は夕方の品ぞろえを見直し、定期購入の案内を店頭でも配ります。
+  en:
+    config: { rules: { max-paragraph-length: strict } }
+    before: |
+      Sales this term rose by a tenth over last year, and most of the growth came from the new subscription plan that we launched in the spring. In-store sales, on the other hand, fell below last year's level for three months in a row, with weekday evenings down the most. At the store managers' meeting, several people pointed to the competitor that opened nearby and to the thin evening range as likely causes. Next term we will review the evening range and hand out subscription leaflets in store, so that both numbers go up together.
+    after: |
+      Sales this term rose by a tenth over last year. Most of the growth came from the new subscription plan.
+
+      In-store sales fell for three months in a row. Weekday evenings fell the most.
+
+      Next term we will review the evening range and hand out subscription leaflets in store.
+
+not_flagged:
+  ja: 文の数が多くても、短い文を重ねただけの段落（普通の長さの文を上限の数だけ並べたより短いもの）は指しません。
+  en: A paragraph of many short sentences is not reported, as long as it is shorter than that many sentences of ordinary length.
+level_meaning:
+  ja: 一つの段落に {limit} 文まで
+  en: up to {limit} sentences in a paragraph

package/rules/max-sentence-length.yaml

@@ -16,6 +16,15 @@ message:
   ja: この文は {count} 文字あります（{limit} 文字まで）
   en: "This sentence runs {count} {count|word|words} (limit {limit})"
 
+# 文書と違う言語で書いた文。和文の中の英文は語で、英文の中の和文は文字で数え、その言語の段と比べる。
+messages:
+  embedded-en:
+    ja: この英文は {count} 語あります（{limit} 語まで）
+    en: "This English sentence runs {count} {count|word|words} (limit {limit})"
+  embedded-ja:
+    ja: この和文は {count} 文字あります（{limit} 文字まで）
+    en: "This Japanese sentence runs {count} {count|character|characters} (limit {limit})"
+
 how_to_fix:
   ja: 接続助詞のところで 2 文に割ってください。それだけで読めるようになります。
   en: Split it in two at the conjunction.
@@ -55,8 +64,35 @@ by_genre:
     en: { strict: 80, normal: 130, relaxed: 180 }
   legal/judgment:
     ja: { strict: 250, normal: 350, relaxed: 450 }
+  # 英語の定義は、限定を重ねた名詞句の一文になる。英語の用語集で測り、normal が列挙を詰めた定義や長い注記だけを指すように置いた。
+  # 日本語は既定の上限のままで、すでに最も長い一握りだけを指していた。
+  docs/glossary:
+    en: { strict: 30, normal: 40, relaxed: 50 }
   academic:
     ja: { strict: 100, normal: 140, relaxed: 180 }
     en: { strict: 35, normal: 50, relaxed: 65 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 読み終える前に主語を見失うほど長い一文
+  en: A sentence so long that the reader loses the subject before the verb
+example:
+  ja:
+    before: |
+      新しい料金体系は先週の会議で営業部から提案があったもので来月から試験的に導入することになりましたが、既存の顧客への説明のしかたと請求システムを直す時期がまだ決まっていないため、担当者を決めたうえで今週中に進め方を相談したいと考えています。
+    after: |
+      新しい料金体系を、来月から試験的に導入します。既存の顧客への説明のしかたと、請求システムを直す時期はまだ決まっていません。今週中に担当者を決め、進め方を相談します。
+  en:
+    before: |
+      The new pricing, which the sales team proposed at last week's meeting, will be trialled from next month, but because we have not yet decided how to explain it to existing customers or when to change the billing system, we would like to agree on a plan this week.
+    after: |
+      The new pricing will be trialled from next month. We have not yet decided how to explain it to existing customers, or when to change the billing system. We will agree on a plan this week.
+
+not_flagged:
+  ja: 見出し、表のセル、コードは数えません。法令や論文のように長い一文が普通の種類では、ジャンルが上限を長くします。
+  en: Headings, table cells and code are not counted. Genres where long sentences are normal (statutes, papers) raise the limit.
+level_meaning:
+  ja: 一文 {limit} 字まで
+  en: up to {limit} words in a sentence

package/rules/ngram-repetition.yaml

@@ -11,8 +11,8 @@ name:
   en: Repeated phrasing
 
 why:
-  ja: 同じ言い回しが何度も出ると、読み手は新しいことが書かれていないと感じます。文字の並びで見ているので、どの言語でも同じように効きます。
-  en: The same phrasing again and again reads as nothing new being said. Measured on character n-grams, so it works the same in any language.
+  ja: 同じ言い回しが何度も出ると、読み手は新しいことが書かれていないと感じます。日本語は文字の並びで、英語は語の切れ目にそろえた並びで数えます。一覧の項目ごとに付く括弧の札・リンクの文字・記号は、書き手の言い回しではないので数えません。
+  en: The same phrasing again and again reads as nothing new being said. Counted on runs of whole words in English and of characters in Japanese. Bracketed tags, link text and symbols that a listing repeats on every entry are not the writer's phrasing, and are not counted.
 
 message:
   ja: 「{word}」が {count} 回出てきます（{limit} 回まで）
@@ -25,3 +25,30 @@ how_to_fix:
 levels: { strict: 3, normal: 5, relaxed: 9 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 同じ言い回しが何度も出てきて、新しいことを言っていないように読める所
+  en: The same phrase used over and over, so nothing new seems to be said
+example:
+  ja:
+    pad: true
+    config: { rules: { ngram-repetition: strict } }
+    before: |
+      お客様の声を大切にしています。商品開発でもお客様の声を大切にしています。店頭でもお客様の声を大切にしています。電話の窓口でもお客様の声を大切にしています。
+    after: |
+      お客様の声を大切にしています。商品開発では試作品を常連の方に使ってもらい、店頭では買い物のあとに感想を聞いています。
+  en:
+    pad: true
+    config: { rules: { ngram-repetition: strict } }
+    before: |
+      We listen to our customers. In product design we listen to our customers. In our stores we listen to our customers. On the phone we listen to our customers.
+    after: |
+      We listen to our customers. Regulars try every prototype, and store staff ask shoppers what they thought.
+
+not_flagged:
+  ja: 一覧の飾り（各項目に付くタグやリンクの文字）と、名前にかかる語句は数えません。短い文書は測りません。
+  en: Tags, link text and symbols that a listing repeats on every entry, and the words around a repeated name, are not counted. Short documents are not measured.
+level_meaning:
+  ja: 同じ言い回し {limit} 回まで
+  en: up to {limit} uses of the same phrase

package/rules/no-doubled-joshi.yaml

@@ -26,3 +26,19 @@ how_to_fix:
 levels: { strict: 1, normal: 2, relaxed: 3 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 「会社の部の課の方針」のように、同じ助詞が区切りなしに続く所
+  en: The same Japanese particle repeated with no break, so the reader cannot tell what attaches to what
+example:
+  ja:
+    before: 本社の営業部の第二課の方針を確認しました。
+    after: 本社営業部にある第二課の方針を確認しました。
+
+not_flagged:
+  ja: 読点で区切った並び、「」や『』の中の題名や引用は数えません。
+  en: Items separated by commas, and titles or quotations inside 「」 or 『』, are not counted.
+level_meaning:
+  ja: 同じ助詞の連続 {limit} 回まで
+  en: up to {limit} of the same particle in a row

package/rules/no-em-dash.yaml

@@ -30,3 +30,28 @@ levels:
   en: { strict: 3, normal: 8, relaxed: 20 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: ai-tells
+summary:
+  ja: ダッシュ（——）が多すぎる所。英語では、生成された文章のよく知られた印の一つでもあります
+  en: Too many dashes, which is also one of the better-known marks of generated text
+example:
+  ja:
+    pad: true
+    before: |
+      新しい料金——来月から始まります——は、請求書にも反映されます。支払いの期限——月末です——にご注意ください。
+    after: |
+      新しい料金は来月から始まり、請求書にも反映されます。支払いの期限は月末です。
+  en:
+    pad: true
+    before: |
+      The new prices — which start next month — will show on invoices. Payment is due — as before — at the end of the month.
+    after: |
+      The new prices start next month and will show on invoices. Payment is due at the end of the month, as before.
+
+not_flagged:
+  ja: 短い文書は測りません。英語では、ダッシュそのものを誤りとは言いません。
+  en: Short documents are not measured. In English a dash is not called wrong; only a heavy hand is.
+level_meaning:
+  ja: 1000 字あたり {limit} 個まで
+  en: up to {limit} per 1000 words

package/rules/no-mixed-desumasu.yaml

@@ -3,6 +3,7 @@ layer: L3
 status: experimental
 how_to_find: sentence-ending
 word_list: polite-ending
+extra_word_lists: [neutral-ending]
 requires: [pos]
 languages: [ja]
 severity: warning
@@ -16,8 +17,14 @@ why:
   en: Mixing polite and plain endings leaves the reader unsure who the document addresses. Neither register is wrong; consistency within one document is the point.
 
 message:
-  ja: この文だけ他と文末の調子が違います（文書の中で {count} 文）
-  en: "This sentence's ending register differs from the rest ({count} in this document)"
+  ja: この文だけ他と文末の調子が違います（本文の中で {count} 文）
+  en: "This sentence's ending register differs from the rest ({count} in the body text)"
+
+# 数えるのは、文が属するまとまりの中。message は本文、list は箇条書き 1 つ（番号で始まる段落の並びも）。
+messages:
+  list:
+    ja: この文だけ他と文末の調子が違います（この箇条書きの中で {count} 文）
+    en: "This sentence's ending register differs from the rest ({count} in this list)"
 
 how_to_fix:
   ja: 多いほうに揃えてください。少数派のほうを直すのが、いちばん手数が少なくて済みます。
@@ -27,3 +34,21 @@ how_to_fix:
 levels: { strict: 5, normal: 3, relaxed: 1 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 「です・ます」の中に「だ・である」が混ざった文
+  en: A Japanese sentence whose ending (polite or plain) differs from the rest of the document
+example:
+  ja:
+    before: |
+      新しい料金は来月から始まります。請求書の形式も変わります。支払いの期限は月末です。古い料金は三月で終わる。
+    after: |
+      新しい料金は来月から始まります。請求書の形式も変わります。支払いの期限は月末です。古い料金は三月で終わります。
+
+not_flagged:
+  ja: どちらの調子が正しいかは決めません。多いほうに揃っていない、少ないほうの文だけを指します。本文と箇条書きは別々に数えます。箇条書きの中の少ないほうが文書全体では多いほうなら、その文は指しません。
+  en: Neither register is called right; only the sentences in the minority are pointed at. The body and each list are counted apart, and a sentence in a list's minority is left alone when its register is the document's majority.
+level_meaning:
+  ja: 少ないほうの調子の文が {limit} 文以下のとき、それを指摘
+  en: reported when the minority register has {limit} sentences or fewer

package/rules/no-nakaguro-parallel.yaml

@@ -25,3 +25,23 @@ how_to_fix:
 levels: { strict: 3, normal: 5, relaxed: 8 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 一つの文に「・」で並べた語が多すぎて、どれとどれが組なのか分からない所
+  en: So many items joined by middle dots (・) in one Japanese sentence that the groups blur
+example:
+  ja:
+    before: 対象は営業・企画・総務・経理・人事・法務の各部と、東京・大阪・名古屋の各拠点です。
+    after: |
+      対象は次の部と拠点です。
+
+      - 部: 営業、企画、総務、経理、人事、法務
+      - 拠点: 東京、大阪、名古屋
+
+not_flagged:
+  ja: 行の頭の「・」は箇条書きの印なので数えません。
+  en: A 「・」 at the start of a line is a bullet and is not counted.
+level_meaning:
+  ja: 一文に中黒 {limit} 個まで
+  en: up to {limit} middle dots in a sentence

package/rules/numbering-gap.yaml

@@ -21,6 +21,58 @@ how_to_fix:
   ja: 番号を振り直してください。削った条を欠番として残すなら、「第4条（削除）」のように番号だけを残すと読み手に伝わります。
   en: Renumber. If a provision was removed on purpose, keep its number with a note such as "Section 4 [Deleted]".
 
-levels: { strict: 1, normal: 1, relaxed: 1 }
+levels: { normal: error, relaxed: warning }
 
 use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 第1条の次が第3条、(a) の次が (c) のように、番号が飛んだり重なったりしている所
+  en: A numbered item that skips or repeats a number, such as Article 3 right after Article 1
+example:
+  ja:
+    before: |
+      # 就業規則
+
+      ## 第1条（目的）
+
+      この規則は、働き方の決まりを定める。
+
+      ## 第3条（勤務時間）
+
+      勤務時間は、午前九時から午後六時までとする。
+    after: |
+      # 就業規則
+
+      ## 第1条（目的）
+
+      この規則は、働き方の決まりを定める。
+
+      ## 第2条（勤務時間）
+
+      勤務時間は、午前九時から午後六時までとする。
+  en:
+    before: |
+      # Staff rules
+
+      ## Article 1 (Purpose)
+
+      These rules set out how we work.
+
+      ## Article 3 (Working hours)
+
+      Working hours are from nine to six.
+    after: |
+      # Staff rules
+
+      ## Article 1 (Purpose)
+
+      These rules set out how we work.
+
+      ## Article 2 (Working hours)
+
+      Working hours are from nine to six.
+
+not_flagged:
+  ja: 同じ親の下で隣り合う番号だけを比べます。別の章の番号どうしは比べません。
+  en: Only numbers side by side under the same parent are compared.

package/rules/oxford-comma-consistency.yaml

@@ -3,7 +3,7 @@ layer: L3
 status: experimental
 how_to_find: oxford-comma
 languages: [en]
-extra_word_lists: [participle-word]
+extra_word_lists: [participle-word, example-marker, pair-opener]
 severity: info
 
 name:
@@ -25,3 +25,21 @@ how_to_fix:
 levels: { strict: 3, normal: 2, relaxed: 1 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 英語で、並べた最後の and の前にカンマを打つか打たないかが揃っていない所
+  en: Lists that put a comma before the final "and" in some places and not in others
+example:
+  en:
+    before: |
+      We sell apples, pears, and plums. We ship to homes, offices, and schools. We accept cash, cards and vouchers.
+    after: |
+      We sell apples, pears, and plums. We ship to homes, offices, and schools. We accept cash, cards, and vouchers.
+
+not_flagged:
+  ja: カンマを打つかどうかは決めません。半々に分かれた文書では、どちらが少ないとも言えないので指しません。
+  en: Whether to use the comma is not decided. A document split evenly has no minority and is not reported.
+level_meaning:
+  ja: 少ないほうの打ち方が {limit} 箇所以下のとき指摘
+  en: reported when the minority style appears {limit} times or fewer

package/rules/padded-intro.yaml

@@ -30,3 +30,22 @@ levels:
 
 # プレスリリース・メール・議事録の冒頭は理由や用件を言う所で、つかみではない。
 use_for: [blog, business/report, business/proposal, legal, docs, academic, literature, speech]
+
+group: wording
+summary:
+  ja: 「近年、〜が注目されています」のように、どの文書にも当てはまる書き出し
+  en: An opening such as "In recent years, X has gained attention" that fits any document
+example:
+  ja:
+    before: 近年、生成 AI が注目を集めています。今回、社内の問い合わせ対応に試しました。
+    after: 社内の問い合わせ対応に生成 AI を試し、回答までの時間が半分になりました。
+  en:
+    before: In recent years, generative AI has gained significant attention. We tried it on our internal help desk.
+    after: We tried generative AI on our internal help desk, and replies now take half as long.
+
+not_flagged:
+  ja: 文書の冒頭（最初の 4 文）だけを見ます。本文の途中の「近年」は指しません。
+  en: Only the opening (the first four sentences) is checked; "in recent years" later in the text is not reported.
+level_meaning:
+  ja: 当てはまる書き出しが {limit} 箇所あれば指摘
+  en: reported once there are {limit}

package/rules/paragraph-length-variance.yaml

@@ -23,3 +23,52 @@ how_to_fix:
 levels: { strict: 40, normal: 30, relaxed: 20 }
 
 use_for: [blog, legal, docs, academic, literature, speech]
+
+group: ai-tells
+summary:
+  ja: どの段落もほぼ同じ長さで、型に流しこんだように見える所
+  en: Paragraphs all of about the same length, as if poured into a mould
+example:
+  ja:
+    config: { genre: blog/tech }
+    before: |
+      最初に、道具を手元に入れます。公式のページから、使う機械に合った版を選んでください。
+
+      次に、設定の画面を開きます。右上の歯車の印を押すと、変えられる項目の一覧が出てきます。
+
+      続けて、仲間を招きます。左の端にある招待の画面で、相手の宛先を入れて送ってください。
+
+      最後に、動きを確かめます。試しの文書を一つ置いて、指摘が画面に出ることを見てください。
+    after: |
+      最初に、道具を手元に入れます。
+
+      次に、設定の画面を開きます。右上の歯車の印を押すと、変えられる項目の一覧が出てきます。項目は多いですが、最初に触るのは言語と文書の種類の二つだけで足ります。ほかは、使いながら必要になったときに変えてください。
+
+      続けて、仲間を招きます。
+
+      最後に、動きを確かめます。試しの文書を一つ置いて、指摘が画面に出ることを見てください。
+  en:
+    config: { genre: blog/tech }
+    before: |
+      First, install the tool. Pick the version for your computer from the official download page.
+
+      Next, open the settings. The gear icon at the top right shows everything that you can change.
+
+      Then, invite your team. Enter their addresses on the invite page on the left and press send.
+
+      Finally, check that it works. Add a sample document and look for the findings on the screen.
+    after: |
+      First, install the tool.
+
+      Next, open the settings. The gear icon at the top right shows everything that you can change. There are many options, but at first you only need two: the language and the kind of document. Change the rest when you need to.
+
+      Then, invite your team.
+
+      Finally, check that it works. Add a sample document and look for the findings on the screen.
+
+not_flagged:
+  ja: ビジネス文書と技術文書のジャンルでは見ません。
+  en: Business and technical genres do not run this rule.
+level_meaning:
+  ja: 段落の長さのばらつきが {limit}% 未満なら指摘
+  en: reported when paragraph length varies by less than {limit}%

package/rules/percent-sum-mismatch.yaml

@@ -0,0 +1,58 @@
+id: percent-sum-mismatch
+layer: L3
+status: experimental
+how_to_find: percent-sum-mismatch
+requires: [quantities]
+severity: warning
+
+name:
+  ja: 内訳の割合を足しても 100% にならない
+  en: Shares of a whole that do not add up to 100%
+
+why:
+  ja: 構成比や内訳の百分率を足して 100% にならないと、読み手はどの数字が違うのか、項目が抜けたのかを確かめることになります。項目を足したり消したり、数字を一つだけ直したりしたときに起きます。表のその列の見出しか、箇条書きや表のすぐ上の文・見出しに、全体を分けた割合の語（構成比、内訳、シェア）があるときだけ足します。丸めの誤差は、項目ごとに最後の桁の半分まで（少なくとも 1 ポイント）認めます。
+  en: When the shares of a whole do not add up to 100%, the reader has to work out which figure is wrong or which item is missing. It happens when an item is added or removed, or when one figure is changed. The percentages are added only when the column's header, or the sentence or heading right above the list or the table, names the parts of a whole (breakdown, market share, composition). Rounding is allowed, up to half the last digit per item (at least one point).
+
+message:
+  ja: 内訳の割合の和が {sum} で、100% になりません
+  en: The shares add up to {sum}, not 100%
+
+how_to_fix:
+  ja: 数字を確かめて、違う数字を直すか、抜けた項目（その他など）を足してください。
+  en: Check the figures. Correct the wrong one, or add the missing item (such as "Other").
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 構成比や内訳の百分率を足しても 100% にならない所
+  en: A breakdown whose percentages do not add up to 100%
+example:
+  ja:
+    before: |
+      売上の構成比は次のとおりです。
+
+      - 国内：60%
+      - 海外：30%
+    after: |
+      売上の構成比は次のとおりです。
+
+      - 国内：60%
+      - 海外：40%
+  en:
+    before: |
+      Revenue breakdown by region:
+
+      - US: 60%
+      - Europe: 30%
+    after: |
+      Revenue breakdown by region:
+
+      - US: 60%
+      - Europe: 40%
+
+not_flagged:
+  ja: 割合の語の無い百分率（利用率、伸び率）、複数回答の集計、符号の付いた増減（+3%）、合計の行がある表（合計が内訳の和と合わない の対象）、項目が一つだけのものは足しません。
+  en: 'Percentages not named as shares (rates, growth), multiple-answer counts, signed changes (+3%), a table with a total row (left to "A total that is not the sum of its items"), and a single item are not added.'

package/rules/preamble-length.yaml

@@ -2,6 +2,7 @@ id: preamble-length
 layer: L1
 status: stable
 how_to_find: preamble-length
+requires: [headings]
 severity: info
 
 name:
@@ -23,3 +24,58 @@ how_to_fix:
 levels: { strict: 1, normal: 2, relaxed: 4 }
 
 use_for: [business, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 最初の見出しまでの前置きが長く、本題になかなか入らない所
+  en: Too many paragraphs before the first heading, which delays the point
+example:
+  ja:
+    before: |
+      # 来期の出店計画
+
+      当社はこれまで、駅前を中心に店を増やしてきました。
+
+      この十年で、店の数は二倍になりました。
+
+      一方で、郊外の店の売上は伸び悩んでいます。
+
+      ## 決めたこと
+
+      来期は、郊外の二店を閉じ、駅前に一店を開きます。
+    after: |
+      # 来期の出店計画
+
+      来期は、郊外の二店を閉じ、駅前に一店を開きます。
+
+      ## 理由
+
+      この十年で店の数は二倍になりましたが、郊外の店の売上は伸び悩んでいます。
+  en:
+    before: |
+      # Store plan for next year
+
+      Over the years we have opened most of our stores near stations.
+
+      In the last ten years the number of stores has doubled.
+
+      Suburban stores, however, have struggled to grow.
+
+      ## Decision
+
+      Next year we will close two suburban stores and open one near a station.
+    after: |
+      # Store plan for next year
+
+      Next year we will close two suburban stores and open one near a station.
+
+      ## Why
+
+      The number of stores has doubled in ten years, but suburban stores have struggled to grow.
+
+not_flagged:
+  ja: 表題より下の見出しが一つもない文書は測りません。法務やブログのジャンルでは見ません。
+  en: A document with no heading below its title is not measured. Legal and blog genres do not run this rule.
+level_meaning:
+  ja: 最初の見出しまで {limit} 段落まで
+  en: up to {limit} paragraphs before the first heading

package/rules/preferred-term.yaml

@@ -21,7 +21,34 @@ how_to_fix:
   ja: 「{preferred}」に直してください。固有名詞など、そのままにすべき箇所なら stet で理由を添えて黙らせます。
   en: Change it to "{preferred}". Where it must stay (a product's own name, a quotation), silence it with stet and the reason.
 
+# chaff explain と規則の一覧には指摘が無いので、{preferred} をこう読ませる。
+placeholders:
+  preferred:
+    ja: prefer に並べた使う書き方
+    en: the spelling listed under prefer
+
 # チームが並べた書き方なので、1 つでも指摘する。並べた時点で「使わない」と決めている。
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+
+group: team
+summary:
+  ja: チームで決めた表記と違う書き方（「サーバー」と決めたのに「サーバ」と書いた、など）。chaff.yaml の prefer に書いた組だけを見ます
+  en: A spelling the team has chosen not to use ("e-mail" where the team writes "email"), from prefer in chaff.yaml
+example:
+  ja:
+    config: { prefer: { サーバ: サーバー } }
+    before: 新しいサーバを来週入れます。
+    after: 新しいサーバーを来週入れます。
+  en:
+    config: { prefer: { e-mail: email } }
+    before: Please send it by e-mail.
+    after: Please send it by email.
+
+not_flagged:
+  ja: chaff.yaml の prefer に書いた組だけを見ます。何も書かなければ何も言いません。
+  en: Only the pairs under prefer in chaff.yaml are checked. With nothing listed, it says nothing.
+level_meaning:
+  ja: 当てはまる語が {limit} 箇所あれば指摘
+  en: reported once there are {limit}

package/rules/proper-noun-density.yaml

@@ -25,3 +25,29 @@ how_to_fix:
 levels: { strict: 20, normal: 40, relaxed: 80 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 製品名・会社名・人名が詰まりすぎて、知らない人には文の形が見えない所
+  en: So many product, company and personal names that a newcomer cannot see the sentence
+example:
+  ja:
+    config: { rules: { proper-noun-density: strict } }
+    pad: true
+    before: |
+      田中さんと佐藤さんが、東京の丸の内にあるトヨタとソニーとパナソニックの展示を見てから、大阪の梅田で日立の鈴木さんと会いました。翌日は京都で任天堂の山本さんと、神戸で川崎重工の中村さんと会い、名古屋に戻ってデンソーの小林さんとトヨタの加藤さんに報告しました。
+    after: |
+      営業部の二人が、取引先三社の展示を見てから、大阪で別の取引先の担当者と会いました。翌日は関西の二社を回り、名古屋に戻って取引先二社に報告しました。
+  en:
+    pad: true
+    before: |
+      Alice and Bob from Contoso met Carol from Fabrikam in Seattle, then flew with Dave from Northwind to Boston to see Erin at Tailspin and Frank at Litware.
+    after: |
+      Two of our sales team met three customers on the West Coast, then flew to Boston to meet two more.
+
+not_flagged:
+  ja: chaff.yaml の names に書いた名前は、何語に分かれても 1 つと数えます。短い文書（日本語 500 字、英語 200 語より短いもの）は測りません。
+  en: A name listed under names in chaff.yaml counts as one, however many words it has. Short documents (under 200 words) are not measured.
+level_meaning:
+  ja: 1000 字あたり {limit} 個まで
+  en: up to {limit} per 1000 words