chaffjs 0.17.0 → 0.18.0

package/rules/heading-echo.yaml

@@ -29,3 +29,34 @@ levels:
   relaxed: 75
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 見出しのすぐ後の文が、見出しをほぼそのまま繰り返している所
+  en: A first sentence that only repeats the heading above it
+example:
+  ja:
+    before: |
+      ## 経費の精算方法
+
+      経費の精算方法について説明します。領収書を添えて、月末までに申請してください。
+    after: |
+      ## 経費の精算方法
+
+      領収書を添えて、月末までに申請してください。
+  en:
+    before: |
+      ## How to claim expenses
+
+      This section explains how to claim expenses. Attach the receipt and submit it by the end of the month.
+    after: |
+      ## How to claim expenses
+
+      Attach the receipt and submit it by the end of the month.
+
+not_flagged:
+  ja: 短い見出し（言葉が少なく、重なりを測れないもの）は見ません。見出しの頭の番号の札（例 3：、Step 3:、1.、第2章）は重なりに数えません。
+  en: Headings too short to measure an overlap are not checked. A number label at the head of a heading (Step 3:, Example 4:, 1., Chapter 2:) is not counted in the overlap.
+level_meaning:
+  ja: 見出しと直後の文の重なりが {limit}% 以上なら指摘
+  en: reported when the first sentence overlaps the heading by {limit}% or more

package/rules/heading-level-skip.yaml

@@ -0,0 +1,78 @@
+id: heading-level-skip
+layer: L1
+status: experimental
+how_to_find: heading-level-skip
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 見出しの深さが飛んでいる
+  en: Heading level skipped
+
+why:
+  ja: 「##」の次に「####」が来ると、間の一段が抜けます。目次や画面読み上げは見出しの深さで文書の形を伝えるので、抜けた段は「どこかの節が消えた」ように読めます。見た目の大きさのために深さを選ぶと起きます。最初の見出しは何段から始めてもよく、一つ前の見出しより二段以上深いときだけ指摘します（markdownlint の MD001 と同じ数え方）。
+  en: A "####" right after a "##" leaves out a level. A table of contents and a screen reader show a document's shape by heading level, so the missing level reads as a section that went missing. It happens when a level is chosen for its size on screen. The first heading may start at any level; only a heading two or more levels deeper than the one before it is reported (as markdownlint's MD001 counts).
+
+message:
+  ja: 見出し「{heading}」の深さが {from} から {to} へ飛んでいます（{expected} のはず）
+  en: 'Heading "{heading}" goes from level {from} to level {to} (expected {expected})'
+
+how_to_fix:
+  ja: 一つ前の見出しより一段だけ深くしてください。文字の大きさを変えたいだけなら、深さではなく表示の設定で変えてください。
+  en: Make the heading one level deeper than the one before it. If only the size on screen was the point, change the style instead of the level.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 「##」の次に「####」が来るように、見出しの深さが一段以上飛んでいる所
+  en: A heading two or more levels deeper than the one before it, as "####" right after "##"
+example:
+  ja:
+    before: |
+      # 手順書
+
+      ## 準備
+
+      道具をそろえます。
+
+      #### 注意
+
+      手袋をはめます。
+    after: |
+      # 手順書
+
+      ## 準備
+
+      道具をそろえます。
+
+      ### 注意
+
+      手袋をはめます。
+  en:
+    before: |
+      # Setup guide
+
+      ## Before you start
+
+      Gather the tools.
+
+      #### Safety
+
+      Wear gloves.
+    after: |
+      # Setup guide
+
+      ## Before you start
+
+      Gather the tools.
+
+      ### Safety
+
+      Wear gloves.
+
+not_flagged:
+  ja: 最初の見出しは何段から始めてもかまいません。浅くなる見出し（「####」の次の「##」）も指しません。
+  en: The first heading may start at any level, and a heading that goes back up ("##" after "####") is not reported.

package/rules/hiragana-fukushi.yaml

@@ -26,3 +26,19 @@ how_to_fix:
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 「殆ど」「勿論」のように、ひらがなのほうが読みやすい副詞を漢字で書いた所
+  en: A Japanese adverb written in rare kanji where kana is easier to read
+example:
+  ja:
+    before: 参加者の殆どが、勿論その案に賛成しました。
+    after: 参加者のほとんどが、もちろんその案に賛成しました。
+
+not_flagged:
+  ja: 一覧にある副詞だけを見ます。常用漢字で普通に書く副詞（「必ず」「特に」など）は指しません。
+  en: Only the adverbs on chaff's list are checked; adverbs normally written in common kanji are not.
+level_meaning:
+  ja: 当てはまる語が {limit} 箇所あれば指摘
+  en: reported once there are {limit}

package/rules/image-alt-text.yaml

@@ -0,0 +1,54 @@
+id: image-alt-text
+layer: L1
+status: experimental
+how_to_find: image-alt-text
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 画像に代替テキストが無い
+  en: Image without alt text
+
+why:
+  ja: 画像が読み込めないときと、画面読み上げで読むときは、代替テキストだけが画像の代わりに伝わります。「![](図1.png)」のように空だと、そこに何があったのか読み手には分かりません。HTML の <img> は alt 属性が無いものだけを数え、alt="" は飾りの画像と書き手が明示したものとして数えません（markdownlint の MD045 と同じ）。
+  en: When an image does not load, or a screen reader reads the page, the alt text is all that stands in for it. With an empty one ("![](chart.png)") the reader cannot tell what was there. An HTML <img> is reported only when it has no alt attribute; alt="" says the image is decoration and is not counted (as markdownlint's MD045).
+
+message:
+  ja: 画像「{image}」に代替テキストがありません
+  en: 'Image "{image}" has no alt text'
+
+how_to_fix:
+  ja: 画像が伝えることを一言で書いてください（![4月の売上の推移](図1.png)）。飾りの画像なら、HTML で alt="" と書くと読み上げが飛ばします。
+  en: Write what the image shows in a few words ("![Sales by month, April](chart.png)"). If it is decoration, write alt="" in HTML so screen readers skip it.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 「![](図.png)」のように、代替テキストの無い画像
+  en: An image with no alt text, as in "![](chart.png)"
+example:
+  ja:
+    before: |
+      四月から六月の売上です。
+
+      ![](sales.png)
+    after: |
+      四月から六月の売上です。
+
+      ![四月から六月の売上の推移](sales.png)
+  en:
+    before: |
+      Sales from April to June.
+
+      ![](sales.png)
+    after: |
+      Sales from April to June.
+
+      ![Sales from April to June](sales.png)
+
+not_flagged:
+  ja: HTML で alt="" と書いた画像は、飾りと明示したものとして指しません。引用（>）とコードの中の画像も見ません。
+  en: An HTML image with alt="" is marked as decoration and is not reported, nor is an image in a quotation (>) or in code.

package/rules/internal-jargon.yaml

@@ -25,3 +25,24 @@ how_to_fix:
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+
+group: team
+summary:
+  ja: 「横展開」「握る」のように、社内でしか通じない言葉。chaff.yaml の jargon に書いた語だけを見ます
+  en: Words that only work inside your team, from jargon in chaff.yaml
+example:
+  ja:
+    config: { jargon: [横展開] }
+    before: この取り組みを、ほかの部にも横展開します。
+    after: この取り組みを、ほかの部でも同じように始めます。
+  en:
+    config: { jargon: [ping] }
+    before: I will ping the vendor about the quote.
+    after: I will email the vendor about the quote.
+
+not_flagged:
+  ja: chaff.yaml の jargon に書いた語だけを見ます。何も書かなければ何も言いません。
+  en: Only the words under jargon in chaff.yaml are checked. With nothing listed, it says nothing.
+level_meaning:
+  ja: 当てはまる語が {limit} 箇所あれば指摘
+  en: reported once there are {limit}

package/rules/katakana-long-vowel.yaml

@@ -0,0 +1,98 @@
+id: katakana-long-vowel
+layer: L3
+status: experimental
+how_to_find: katakana-long-vowel
+# 語は形態素解析で取る。複合語の中の「ユーザー」も一語として見る。品詞が無ければ動かない。
+requires: [pos]
+# ending: keep が読む、辞書が「ー」付きで知る語の印。この rule が動くときだけ lang-ja が辞書に聞く。
+token_features: [LongVowelEnding]
+languages: [ja]
+severity: warning
+
+name:
+  ja: カタカナ語の語末の「ー」がそろっていない
+  en: The final ー of katakana words is inconsistent
+
+why:
+  ja: 「コンピューター」と「コンピュータ」のように、カタカナ語の語末の「ー」は付ける書き方と省く書き方があります。どちらも正しく、困るのは一つの文書の中で混ざることです。読み手は別のものかと迷い、検索でも片方を取りこぼします。設定が無ければ、同じ語が両方で書かれた所だけを指摘し、違う語どうし（サーバーとブラウザ）は比べません。options の ending を drop か keep にすると、決めた書き方に合わない語をすべて指摘します。音は「コ・ン・ピュ・ー・タ・ー」で 6 音と数えます（小さい「ャュョァィゥェォ」は前の字と合わせて 1 音、「ッ」「ン」「ー」は 1 音ずつ）。辞書が固有名詞と知っている語（ディズニー）と、chaff.yaml の names に並べた名前は見ません。
+  en: A katakana loanword can be written with or without its final long-vowel mark (コンピューター / コンピュータ). Both are right; what reads badly is mixing them in one document, which makes a reader wonder whether they differ and makes a search miss one. With no setting chaff points only at a word written both ways, and does not compare different words (サーバー and ブラウザ). Setting ending under options to drop or keep points at every word written the other way. Morae are counted as コ・ン・ピュ・ー・タ・ー, six (a small ャュョァィゥェォ joins the kana before it; ッ, ン and ー are one each). Words the dictionary knows as proper nouns (ディズニー) and the names under names in chaff.yaml are left alone.
+
+message:
+  ja: 「{matched}」は語末の「ー」がほかと違います（「{preferred}」）
+  en: 'The final ー of "{matched}" differs from the rest ("{preferred}")'
+
+messages:
+  same-word:
+    ja: 「{matched}」と「{preferred}」が混ざっています（この語は {of} 回のうち {count} 回が「{matched}」）
+    en: '"{matched}" and "{preferred}" are both used ({count} of {of} are "{matched}")'
+  drop:
+    ja: 「{matched}」は語末の「ー」を省いて「{preferred}」と書きます（{min_morae} 音以上の語）
+    en: 'Write "{preferred}", without the final ー ({min_morae} morae or more)'
+  keep:
+    ja: 「{matched}」は語末の「ー」を付けて「{preferred}」と書きます
+    en: 'Write "{preferred}", with the final ー'
+
+how_to_fix:
+  ja: 「{preferred}」に直してください。どちらに寄せるかチームで決めているなら、chaff.yaml の options で ending を決めておくと、この文書の多いほうではなく、決めた書き方で見ます。製品名など、そのままにすべき語は options の except か names に並べます。
+  en: Change it to "{preferred}". If the team has decided which way, set ending under options in chaff.yaml, and chaff checks against that instead of the document's usual way. List a word that must stay as it is (a product's name) under except in options, or under names.
+
+placeholders:
+  matched:
+    ja: 見つけた語
+    en: the word found
+  preferred:
+    ja: 直した書き方
+    en: the other way of writing it
+
+# 何語違えば指摘するか。1 は「1 語でも違えば」。
+levels: { strict: 1, normal: 1, relaxed: 3 }
+
+options:
+  ending:
+    kind: choice
+    default: consistent
+    about:
+      ja: 語末の「ー」をどちらに寄せるか
+      en: Which way the final ー goes
+    choices:
+      consistent:
+        ja: 決めない。文書の中でそろっているかだけを見る
+        en: No side taken; only checks that the document is consistent
+      drop:
+        ja: min_morae 音以上の語の語末の「ー」を省く（電子情報通信学会、JIS Z 8301:2011 まで）
+        en: Drop the final ー on words of min_morae morae or more (IEICE; JIS Z 8301 up to 2011)
+      keep:
+        ja: 語末の「ー」を付ける（文化庁「外来語の表記」、JIS Z 8301:2019）。「ー」の無い語は、辞書が「ー」付きで知っている語（メモリ）か、文書がほかで「ー」付きで書く語だけを見る
+        en: Keep the final ー (the Agency for Cultural Affairs' 外来語の表記; JIS Z 8301:2019). A word without one is checked only when the dictionary knows it with one (メモリ) or the document writes it with one elsewhere
+  min_morae:
+    kind: count
+    default: 3
+    about:
+      ja: 何音以上の語を見るか。語末の「ー」も 1 音と数える（コンピューターは 6 音、カーは 2 音）
+      en: The shortest word checked, in morae, counting the final ー (コンピューター is six, カー two)
+  except:
+    kind: words
+    default: []
+    about:
+      ja: 見ない語。どちらの書き方で並べても、両方の書き方が外れる
+      en: Words left alone; listing either way of writing one exempts both
+
+use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: カタカナ語の語末の「ー」を、同じ語で付けたり省いたりしている所（コンピューターとコンピュータ）。options で省く・付けるを決めることもできます
+  en: A katakana word written both with and without its final ー in one document (コンピューター and コンピュータ); options can set which way
+example:
+  ja:
+    before: |
+      新しいコンピューターを買いました。古いコンピュータは来月捨てます。
+    after: |
+      新しいコンピューターを買いました。古いコンピューターは来月捨てます。
+
+not_flagged:
+  ja: 違う語どうし（サーバーとブラウザ）は比べません。2 音の語（カー）、辞書が固有名詞と知っている語、chaff.yaml の names に並べた名前も見ません。
+  en: Different words (サーバー and ブラウザ) are not compared. Two-mora words (カー), words the dictionary knows as proper nouns and the names under names in chaff.yaml are left alone.
+level_meaning:
+  ja: 違う書き方の語が {limit} 箇所あれば指摘
+  en: reported once {limit} words go the other way

package/rules/kutoten-consistency.yaml

@@ -0,0 +1,53 @@
+id: kutoten-consistency
+layer: L3
+status: experimental
+how_to_find: kutoten-consistency
+languages: [ja]
+severity: warning
+
+name:
+  ja: 句読点の書き方がそろっていない
+  en: Japanese commas and periods are mixed
+
+why:
+  ja: 読点を「、」と「，」、句点を「。」と「．」のどちらで書くかは、どちらでも読めます（横書きの論文や公用文には「，」があります）。困るのは一つの文書の中で混ざることで、貼り付けた文や別の人が書いた段落が、そこだけ違って見えます。chaff はどちらが正しいかを決めず、読点と句点のそれぞれで、文書の中で少ないほうを指摘します。数の中の「，」「．」（１，０００、３．５）、番号の印の点（１．はじめに、２．確認）、一、二文字の英字の印の後ろの点（Ｑ．）、鉤括弧で引いたものの中と、注の番号で始まる行や URL を含む文（文献や出典の書き方に従う）は数えません。
+  en: Whether Japanese text uses 、 or ， for its commas and 。 or ． for its periods is a choice either way (， is common in horizontal academic and official writing). What reads badly is mixing both in one document, which makes a pasted sentence or another writer's paragraph stand out. chaff does not decide which is right; for commas and for periods separately, it points at whichever the document uses less. Marks inside a number (１，０００, ３．５), after a list number (１．はじめに, ２．確認), after a one- or two-letter label (Ｑ．), inside a 「」 quotation, and in a sentence that starts with a note number or holds a URL (a citation follows its own style) are not counted.
+
+message:
+  ja: 「{mark}」と書いています（この文書はふつう「{usual}」。{of} 箇所のうち {count} 箇所が違う）
+  en: '"{mark}" here, where the document usually writes "{usual}" ({count} of {of})'
+
+messages:
+  comma:
+    ja: 読点を「{mark}」と書いています（この文書はふつう「{usual}」。{of} 箇所のうち {count} 箇所が違う）
+    en: 'The Japanese comma is written "{mark}" here, where the document usually writes "{usual}" ({count} of {of})'
+  period:
+    ja: 句点を「{mark}」と書いています（この文書はふつう「{usual}」。{of} 箇所のうち {count} 箇所が違う）
+    en: 'The Japanese period is written "{mark}" here, where the document usually writes "{usual}" ({count} of {of})'
+
+how_to_fix:
+  ja: 文書の多いほうの書き方に合わせてください。チームで決めているなら、STYLE.md に書いておくと迷いません。
+  en: Match the way the rest of the document does it. If the team has decided, write it in the style guide.
+
+# 何箇所違えば指摘するか。1 は「1 箇所でも混ざっていれば」。
+levels: { strict: 1, normal: 1, relaxed: 3 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 読点の「、」と「，」、句点の「。」と「．」が、一つの文書の中で混ざっている所
+  en: Japanese commas written both 、 and ，, or periods written both 。 and ．, in one document
+example:
+  ja:
+    before: |
+      申込書は、窓口で受け付けます。書類は，担当者が確認します。結果は、翌日に知らせます。
+    after: |
+      申込書は、窓口で受け付けます。書類は、担当者が確認します。結果は、翌日に知らせます。
+
+not_flagged:
+  ja: 数の中の「，」「．」（１，０００、３．５）、番号の印の点（１．）、「Ｑ．」のような英字の印、「」の中、注の番号で始まる行と URL を含む文は数えません。どちらの書き方が正しいかは決めません。
+  en: Marks inside numbers (１，０００, ３．５), after a list number (１．), in a letter label (Ｑ．), inside 「」, and in a note or a sentence with a URL are not counted. Neither way is called right.
+level_meaning:
+  ja: 少ないほうの書き方が {limit} 箇所あれば指摘
+  en: reported once {limit} places go against the document's habit

package/rules/latin-spacing.yaml

@@ -7,16 +7,17 @@ severity: warning
 # 番号・識別子として書かれた数を見分けるのに、数の後ろの語の品詞を使う。無ければ全部数える。
 uses: [pos]
 # 番地（千代田区紀尾井町1-3）を、都道府県までの地名の後ろの範囲（東京都2-3 営業日）と分ける。
-# 日付・時刻（9月、2026年、10時5分）を、長さ（3ヶ月、3 時間）と分ける。
-extra_word_lists: [prefecture-unit, date-time-unit, calendar-unit, calendar-year-unit]
+# 日付・時刻（9月、2026年、令和8年、10時5分）を、長さ（3ヶ月、3 時間）と分ける。
+# 番号と組んで名前を付ける語（問3、第1節）を見分ける。
+extra_word_lists: [prefecture-unit, date-time-unit, calendar-unit, calendar-year-unit, calendar-era, numbered-label]
 
 name:
   ja: 英数字の前後の空白がそろっていない
   en: Spacing around Latin text is inconsistent
 
 why:
-  ja: 日本語と英字・数字のあいだを空けるか詰めるかは、どちらでも読めます。困るのは一つの文書の中で混ざることで、読み手には違いに意味があるように見えます。chaff はどちらが正しいかを決めず、文書の中で少ないほうを指摘します。英字と、数字の前、数字の後ろは別々に数えます。「を 3回」のように、数字の前は空けて助数詞とは詰める書き方がふつうにあるからです。「3GBの」のように数字に続く単位は、英字ではなく数字の側として数えます。逆に「H30 等」「EC2 で」「Phase 1 は」のように英字で始まって数字で終わる名前は、英字の側として数えます。「073-489-5909」「2026-06-02」のような番号は数量ではないので数えません。日付・時刻（「9月」「2026年」「10月1日」「3時」「10時5分」）も、数と単位を詰めて書く決まりなので、その中の境目は数えません（日付の前の空白は数えます）。長さ（「3ヶ月」「3 時間」「5日で」「3年」）は数量として数えます。題や注の番号として書かれた数（「3.1 リサーチの原則」の節番号、※1 の注番号、行の頭に続き番号で並べた注の番号）、0 で始まる組を含む番号（102-0094）、〒の後ろの郵便番号（〒100-8916）、市・区・町まで下りた地名のすぐ後ろの番地（千代田区紀尾井町1-3）も、後ろの空白が番号と題・項目の区切りなので数えません。鉤括弧（「」『』）で引いた題名や発言の中も、空け方は引いた元のものなので数えません。
-  en: Whether to put a space between Japanese and Latin letters or digits is a choice either way. What reads badly is mixing both in one document, which suggests the difference means something. chaff does not decide which is right; it points at whichever the document uses less. Letters, the space before a digit and the space after one are counted separately, since spacing before a number but not before its counter is common. A unit after a number (3GB) counts with the number; a name that starts with a letter and ends in a digit (H30, EC2, Phase 1) counts with the letters. A code such as a phone number or a date (073-489-5909, 2026-06-02) is not a quantity and is not counted. Nor is the inside of a date or a time written with units (9月, 2026年, 10月1日, 3時, 10時5分), which is packed by convention; the space before it still counts. A length of time (3ヶ月, 3 時間, 5日で, 3年) is a quantity and counts. Neither is a number written as the label of a title or a note (a section number such as 3.1 before its title, a note number after ※, the numbers of notes listed one per line in sequence), a code with a part starting with 0 (102-0094), a postal code after 〒 (〒100-8916), or a hyphenated address number right after a city, ward or town (千代田区紀尾井町1-3), since the space after it separates the label from its title or the next item. Nor is the spacing inside a title or a quotation in 「」 or 『』, which is the source's, not the writer's.
+  ja: 日本語と英字・数字のあいだを空けるか詰めるかは、どちらでも読めます。困るのは一つの文書の中で混ざることで、読み手には違いに意味があるように見えます。chaff はどちらが正しいかを決めず、文書の中で少ないほうを指摘します。英字と、数字の前、数字の後ろは別々に数えます。「を 3回」のように、数字の前は空けて助数詞とは詰める書き方がふつうにあるからです。「3GBの」のように数字に続く単位は、英字ではなく数字の側として数えます。逆に「H30 等」「EC2 で」「Phase 1 は」のように英字で始まって数字で終わる名前は、英字の側として数えます。「073-489-5909」「2026-06-02」のような番号は数量ではないので数えません。日付・時刻（「9月」「2026年」「令和8年」「10月1日」「3時」「10時5分」）も、数と単位を詰めて書く決まりなので、その中の境目も、前の境目（「は 9月」「午後3時」）も数えません。長さ（「3ヶ月」「3 時間」「5日で」「3年」）は数量として数えます。題や注の番号として書かれた数（「3.1 リサーチの原則」の節番号、※1 の注番号、行の頭に続き番号で並べた注の番号、番号が増えていく箇条書きの頭の番号、「問3」「図2」のように語のすぐ後ろに書いた番号）、0 で始まる組を含む番号（102-0094）、〒の後ろの郵便番号（〒100-8916）、市・区・町まで下りた地名のすぐ後ろの番地（千代田区紀尾井町1-3）も、後ろの空白が番号と題・項目の区切りなので数えません。「第1節 AI の…」の「第1節」の後ろの空白も同じです。鉤括弧（「」『』）で引いた題名や発言の中も、空け方は引いた元のものなので数えません。
+  en: Whether to put a space between Japanese and Latin letters or digits is a choice either way. What reads badly is mixing both in one document, which suggests the difference means something. chaff does not decide which is right; it points at whichever the document uses less. Letters, the space before a digit and the space after one are counted separately, since spacing before a number but not before its counter is common. A unit after a number (3GB) counts with the number; a name that starts with a letter and ends in a digit (H30, EC2, Phase 1) counts with the letters. A code such as a phone number or a date (073-489-5909, 2026-06-02) is not a quantity and is not counted. Nor is a date or a time written with units (9月, 2026年, 令和8年, 10月1日, 3時, 10時5分), which is packed by convention; neither its inside nor the space before it (は 9月, 午後3時) counts. A length of time (3ヶ月, 3 時間, 5日で, 3年) is a quantity and counts. Neither is a number written as the label of a title or a note (a section number such as 3.1 before its title, a note number after ※, the numbers of notes listed one per line in sequence, numbers opening the items of a list that go up, a number written right after a word such as 問 or 図), a code with a part starting with 0 (102-0094), a postal code after 〒 (〒100-8916), or a hyphenated address number right after a city, ward or town (千代田区紀尾井町1-3), since the space after it separates the label from its title or the next item. The same goes for the space after a division such as 第1節. Nor is the spacing inside a title or a quotation in 「」 or 『』, which is the source's, not the writer's.
 
 message:
   ja: "日本語と{kind}のあいだを{style}（この文書はふつう{usual}。{of} 箇所のうち {count} 箇所が違う）"
@@ -30,3 +31,21 @@ how_to_fix:
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 日本語と英数字のあいだの空白が、文書の中で付いたり付かなかったりしている所
+  en: Spacing between Japanese and Latin letters or digits that is done both ways in one document
+example:
+  ja:
+    before: |
+      表は Excel で作り、Word に貼ります。図は PowerPoint で描きます。最後にPDFにします。
+    after: |
+      表は Excel で作り、Word に貼ります。図は PowerPoint で描きます。最後に PDF にします。
+
+not_flagged:
+  ja: 電話番号や日付のような番号、単位つきの日付や時刻（9月、10時5分）、見出しの番号、「」の中は数えません。どちらの空け方が正しいかは決めません。
+  en: Codes such as phone numbers and dates, dates and times with units (9月, 10時5分), heading numbers and quotations are not counted. Neither way is called right.
+level_meaning:
+  ja: 少ないほうの空け方が {limit} 箇所あれば指摘
+  en: reported once {limit} places go against the document's habit

package/rules/max-kanji-continuous.yaml

@@ -29,3 +29,19 @@ how_to_fix:
 levels: { strict: 6, normal: 8, relaxed: 12 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 「新規顧客獲得施策検討会議」のように、漢字だけが長く続く所
+  en: A long run of kanji with no kana between them, which Japanese readers have to take apart
+example:
+  ja:
+    before: 来週、新規顧客獲得施策検討会議を開きます。
+    after: 来週、新しい顧客を増やす施策を話し合う会議を開きます。
+
+not_flagged:
+  ja: chaff.yaml の names に書いた組織名や製品名、法令の条番号（第二十二条第二項）は数えません。
+  en: Names listed under names in chaff.yaml, and provision numbers in statutes (第二十二条第二項), are not counted.
+level_meaning:
+  ja: 漢字の連続 {limit} 字まで
+  en: up to {limit} kanji in a row

package/rules/max-paragraph-length.yaml

@@ -37,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.
@@ -64,3 +73,26 @@ by_genre:
     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