chaffjs 0.21.0 → 0.23.0

package/rules/currency-notation-consistency.yaml

@@ -0,0 +1,77 @@
+id: currency-notation-consistency
+layer: L2
+status: stable
+how_to_find: currency-notation
+severity: info
+
+name:
+  ja: 通貨の書き方が混ざっている
+  en: A currency written two ways
+
+why:
+  ja: 同じ通貨の金額を「1,000円」と「¥1,000」、「$20」と「USD 20」のように二通りに書くと、読み手は別の通貨か、別の扱いの金額かと迷います。見積もりや資料を寄せ集めたときに起きます。どの書き方が正しいかは決めず、通貨ごとに文書の中で少ないほうを指します。
+  en: When one currency is written two ways in one document ("$20" and "USD 20", "1,000円" and "¥1,000"), the reader wonders whether a different currency or a different kind of amount is meant. It happens when quotes and notes are pasted together. chaff does not decide which way is right; for each currency it points at the way the document uses less.
+
+message:
+  ja: 「{written}」と書いています（この文書はこの通貨をふつう「{usual}」のように書きます。{of} 箇所のうち {count} 箇所が違う）
+  en: '"{written}" here, where the document usually writes this currency like "{usual}" ({count} of {of})'
+
+how_to_fix:
+  ja: 文書の多いほうの書き方に合わせてください。チームで決めているなら、STYLE.md に書いておくと迷いません。
+  en: Match the way the rest of the document writes the currency. If the team has decided, write it in the style guide.
+
+# 少ないほうが、その通貨の金額の何パーセントまでなら「混ざっている」と見るか。これを超えたら、文書が使い分けている。
+levels: { strict: 49, normal: 34, relaxed: 20 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 「1,000円」と「¥1,000」、「$20」と「USD 20」のように、一つの文書で同じ通貨の金額を二通りに書いている所
+  en: One currency written two ways in one document, such as "$20" and "USD 20", or "1,000円" and "¥1,000"
+example:
+  ja:
+    before: |
+      基本料金は 3,000円、追加料金は 500円、送料は 800円 です。割引は ¥200 です。
+    after: |
+      基本料金は 3,000円、追加料金は 500円、送料は 800円 です。割引は 200円 です。
+  en:
+    before: |
+      The base fee is $300, the add-on is $50 and shipping is $20. The discount is USD 10.
+    after: |
+      The base fee is $300, the add-on is $50 and shipping is $20. The discount is $10.
+
+not_flagged:
+  ja: 通貨ごとに比べるので、円とドルが並ぶのは混ざりではありません。少ないほうがその通貨の金額の三分の一を超える文書は、使い分けている（表は USD、本文は $）と読んで言いません。二つの書き方が同じ数のときも言いません。コードの中は読みません。
+  en: Each currency is compared with itself, so dollars beside yen is not a mix. When the less common way is over a third of that currency's amounts, the document is read as using both on purpose (USD in tables, $ in prose) and nothing is reported; nor when the two ways are equally common. Code is not read.
+level_meaning:
+  ja: 少ないほうの書き方が、その通貨の金額の {limit}% 以下のとき指摘
+  en: reported when the less common way is {limit}% of that currency's amounts or less
+
+rewrite:
+  ja:
+    direction: その通貨の金額を、文書で多いほうの書き方にそろえてください。数と桁はそのまま残します。
+    pairs:
+      - before: 送料は 800円 です。割引は ¥200 です。
+        after: 送料は 800円 です。割引は 200円 です。
+      - before: 月額 $20、年額 USD 200 です。
+        after: 月額 $20、年額 $200 です。
+    keep:
+      - 金額の数と桁
+      - どの通貨か
+    avoid:
+      - 別の通貨に換算してしまう
+      - 表の通貨の書き方まで本文に合わせて崩す
+  en:
+    direction: Write the currency's amounts the way the document mostly does. Keep the numbers as they are.
+    pairs:
+      - before: Shipping is $20. The discount is USD 10.
+        after: Shipping is $20. The discount is $10.
+      - before: The fee is 500 yen, or ¥450 if paid early.
+        after: The fee is 500 yen, or 450 yen if paid early.
+    keep:
+      - the numbers and their magnitude
+      - which currency each amount is in
+    avoid:
+      - converting an amount to another currency
+      - changing the way a table writes it to match the prose

package/rules/dangling-participle.yaml

@@ -0,0 +1,58 @@
+id: dangling-participle
+layer: L3
+status: stable
+how_to_find: dangling-opener
+requires: [pos]
+languages: [en]
+severity: info
+
+name:
+  ja: 主語の無い分詞の句
+  en: Dangling participle
+
+why:
+  ja: 英語で分詞の句から始めた文（Having reviewed the code, …）は、句の動作をしたのが文の主語だと読まれます。主語が形だけの it や there だと（Having reviewed the code, it is ready.）、コードを見たのが誰なのか文に書かれていません。読み手は一瞬つまずき、意味を補って読むことになります。-ing の分詞の句の直後の主語が it か there で、be が続く形だけを指します。
+  en: 'A sentence that opens with a participle phrase ("Having reviewed the code, …") is read as if the subject did that action. When the subject is an empty "it" or "there" ("Having reviewed the code, it is ready."), the sentence never says who reviewed the code, and the reader has to supply it. Only an opening "-ing" phrase followed by "it" or "there" and a form of "be" is reported.'
+
+message:
+  ja: 「{opener}」の動作をしたのが誰か、文に書かれていません（主語が「{subject}」）
+  en: '"{opener}" has no one to attach to; the subject is an empty "{subject}"'
+
+how_to_fix:
+  ja: 動作をした人を主語にするか（Having reviewed the code, we think it is ready.）、句を節にしてください（After we reviewed the code, it was ready.）。
+  en: Make whoever did the action the subject ("Having reviewed the code, we consider it ready."), or turn the phrase into a clause ("After we reviewed the code, it was ready.").
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  literature: "A narrator and a character speak as they speak, and loose openings are part of a voice."
+  speech: "A transcript keeps the speaker's words."
+
+group: wording
+summary:
+  ja: 英語で、「Having reviewed the code, it is ready.」のように、分詞の句の後ろの主語が形だけの it や there の文
+  en: 'A participle phrase followed by an empty "it" or "there", as in "Having reviewed the code, it is ready."'
+
+example:
+  en:
+    before: Having reviewed the logs, it is clear that the job failed twice.
+    after: Having reviewed the logs, we found that the job failed twice.
+
+not_flagged:
+  ja: 主語が人や物の名詞の文（Having reviewed the code, the team approved it.）、過去分詞で始めた句（Configured with SSO, it is ready.。it そのものを言うことが多い）、決まった言い方として読む句（Given、Based on、Generally speaking、Having said that）、挿入句の it is（Testing it, it is worth noting, requires …）、分詞の句が長く読点の位置が当てにならない文は指しません。英語の文だけを読みます。
+  en: 'A sentence whose subject is a person or a thing ("Having reviewed the code, the team approved it."), an opening past participle ("Configured with SSO, it is ready.", which usually describes "it" itself), openings read as fixed phrases ("Given", "Based on", "Generally speaking", "Having said that"), a parenthetical "it is" ("Testing it, it is worth noting, requires …"), and long openings where the comma cannot be trusted are not reported. Only English sentences are read.'
+
+rewrite:
+  depth: light
+  en:
+    direction: Give the participle phrase a subject that did its action, or turn the phrase into a clause with its own subject. Keep what the sentence says.
+    pairs:
+      - before: Having reviewed the logs, it is clear that the job failed twice.
+        after: Having reviewed the logs, we found that the job failed twice.
+      - before: Looking at the totals, there is a gap of 40 hours.
+        after: Looking at the totals, we see a gap of 40 hours.
+    keep:
+      - what the sentence says and its figures
+    avoid:
+      - inventing who did the action when the document does not say

package/rules/ellipsis-consistency.yaml

@@ -0,0 +1,73 @@
+id: ellipsis-consistency
+layer: L2
+status: stable
+how_to_find: ellipsis-consistency
+severity: info
+
+name:
+  ja: 省略記号の書き方が混ざっている
+  en: Ellipses written two ways
+
+why:
+  ja: 省略の記号を「……」と「・・・」、「…」と「...」のように二通りに書くと、読み手は違いに意味があるのかと迷い、別々の所から貼り合わせた文書に見えます。検索や置換でも片方を取りこぼします。どの書き方が正しいかは決めず、文書の中で少ないほうを指します。
+  en: 'An ellipsis written as "..." in some places and "…" in others makes the reader wonder whether the difference means something, and makes the document look pasted together; a search finds only one kind. chaff does not pick a side; it points at the way the document uses less.'
+
+message:
+  ja: 省略の記号を「{written}」と書いています（この文書はふつう「{usual}」。{of} 箇所のうち {count} 箇所が違う）
+  en: 'The ellipsis "{written}" here, where the document usually writes "{usual}" ({count} of {of})'
+
+how_to_fix:
+  ja: 文書の多いほうの書き方に合わせてください。
+  en: Match the way the rest of the document writes it.
+
+# 少ないほうが、省略記号の何パーセントまでなら「混ざっている」と見るか。これを超えたら、文書が使い分けている。
+levels: { strict: 49, normal: 34, relaxed: 20 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 「……」と「・・・」、「…」と「...」のように、一つの文書で省略の記号を二通りに書いている所
+  en: An ellipsis written two ways in one document, such as "..." and "…"
+example:
+  ja:
+    before: |
+      準備中です……。確認中です……。少々お待ちください・・・。
+    after: |
+      準備中です……。確認中です……。少々お待ちください……。
+  en:
+    before: |
+      Loading… Saving… Please wait...
+    after: |
+      Loading… Saving… Please wait…
+not_flagged:
+  ja: コードの中は見ません。点がさらに続く所（....、…・）は、どの書き方か決められないので数えません。少ないほうが全体の 3 分の 1 を超える文書や、二通りが同じ数の文書は、使い分けていると読んで指しません。
+  en: Code is not read. A longer run of dots ("....") is not counted, since its form is unclear. When the less common way is over a third, or the two are equally common, the document is read as using both on purpose.
+level_meaning:
+  ja: 少ないほうが {limit}% までなら指摘
+  en: reported while the less common way is at most {limit}% of the ellipses
+sources: [vale-styles]
+rewrite:
+  depth: light
+  ja:
+    direction: 指した記号だけを、文書の多いほうの書き方に替えてください。ほかは変えません。
+    pairs:
+      - before: 少々お待ちください・・・。
+        after: 少々お待ちください……。
+      - before: 結果は...まだです。
+        after: 結果は……まだです。
+    keep:
+      - 記号の前後の文
+    avoid:
+      - 省略記号を消して文を書き換える
+  en:
+    direction: Change only the marked ellipsis to the form the rest of the document uses.
+    pairs:
+      - before: Please wait...
+        after: Please wait…
+      - before: The answer is . . . not yet known.
+        after: The answer is… not yet known.
+    keep:
+      - the words around the ellipsis
+    avoid:
+      - dropping the ellipsis or rewriting the sentence

package/rules/figurative-density.yaml

@@ -0,0 +1,84 @@
+id: figurative-density
+layer: L2
+status: stable
+how_to_find: phrase-density
+word_list: figurative-phrase
+uses: [pos]
+severity: info
+
+name:
+  ja: 飾りのたとえが多い
+  en: Too many decorative figures
+
+why:
+  ja: 「まるで魔法のように動く」「呪文のようなコマンド」「おまじないとして書く」のようなたとえは、一つなら文に色を付けますが、重なると何がどう動くのかが書かれないまま文書が進みます。読み手は仕組みを知りたいのに、たとえしか受け取れません。一つ一つは誤りではないので、文書の長さあたりの数で見ます。たとえの一覧は語彙表 figurative-phrase にあり、語ごとに代わりに書くことの例が付いています。
+  en: 'A figure such as "works like magic", "a one-line incantation" or "our secret sauce" adds colour once. Piled up, the document goes on without saying what actually happens, and a reader who wants the mechanism gets only the figure. None of them is wrong alone, so the rule counts them per length of the document. The figures are in the lexicon figurative-phrase, each with what to write instead.'
+
+message:
+  ja: 「{matched}」など、飾りのたとえが 1000 字あたり {density} 個あります
+  en: '"{matched}" and other decorative figures: {density} per 1000 words'
+
+how_to_fix:
+  ja: たとえの代わりに、何がどう動くのか、何ができるのかを書いてください（まるで魔法のように設定が済む → 設定ファイルを読んで自動で済ませる）。
+  en: Replace the figure with what happens ("the config sets itself up like magic" becomes "the tool reads the config file and fills in the defaults").
+
+# 「まるで魔法のように」は一つのたとえに二語が当たるので、既定は 1000 字あたり 2 個まで。
+levels: { strict: 1, normal: 2, relaxed: 3 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Figures are the writer's material in literature."
+  speech: "A speaker's figures are part of the talk."
+
+group: ai-tells
+summary:
+  ja: 「まるで魔法のように」「呪文のような」「おまじない」のような、仕組みの代わりのたとえが多い所
+  en: Decorative figures such as "like magic", "incantation" and "secret sauce" piled up in place of the mechanism
+
+example:
+  ja:
+    pad: true
+    before: |
+      このツールを入れると、まるで魔法のように設定が終わります。最初の一行は呪文のようなものなので、おまじないとして書いておいてください。
+    after: |
+      このツールを入れると、設定ファイルを読んで既定の値を自動で埋めます。最初の一行は文字コードを指定する行なので、消さずに残してください。
+  en:
+    pad: true
+    before: |
+      The installer works like magic. Our secret sauce is a one-line incantation that magically fixes every path.
+    after: |
+      The installer reads your config file and fills in the defaults. The fix is one command that rewrites every path to an absolute one.
+
+not_flagged:
+  ja: 一つ一つは誤りではないので、短い文書は測りません。例を挙げる「〜のような」（A や B のような製品）は数えません。文学と講演のジャンルでは止めています。
+  en: None of these is wrong alone, so short documents are not measured. A plain comparison or example ("tools such as A and B") is not counted. The literature and speech genres turn it off.
+level_meaning:
+  ja: 1000 字あたり飾りのたとえ {limit} 個まで
+  en: up to {limit} decorative figures per 1000 words
+
+rewrite:
+  depth: register
+  ja:
+    direction: たとえを、何がどう動くのか、何ができるのかの説明に替えてください。語彙表の語ごとの書き換えの例に従い、文書に書かれていない仕組みは作りません。
+    pairs:
+      - before: このツールを入れると、まるで魔法のように設定が終わります。
+        after: このツールを入れると、設定ファイルを読んで既定の値を自動で埋めます。
+      - before: 最初の一行はおまじないとして書いておいてください。
+        after: 最初の一行は文字コードを指定する行なので、消さずに残してください。
+    keep:
+      - 書いてある事実と手順
+    avoid:
+      - 文書に書かれていない仕組みを作って書く
+      - たとえを別のたとえに替える
+  en:
+    direction: Replace each figure with what actually happens or what the thing does, following the lexicon's hint for the phrase. Do not invent a mechanism the document does not give.
+    pairs:
+      - before: The installer works like magic.
+        after: The installer reads your config file and fills in the defaults.
+      - before: Our secret sauce is a one-line incantation that fixes every path.
+        after: The fix is one command that rewrites every path to an absolute one.
+    keep:
+      - the facts and steps the document gives
+    avoid:
+      - inventing a mechanism the document does not describe
+      - swapping one figure for another

package/rules/footnote-mismatch.yaml

@@ -0,0 +1,91 @@
+id: footnote-mismatch
+layer: L3
+status: stable
+how_to_find: footnote-mismatch
+severity: warning
+
+name:
+  ja: 注の無い注の印と、印の無い注
+  en: A note mark with no note, or a note nothing points to
+
+why:
+  ja: 本文に「※3」や「[^3]」と書いたのに注3が無ければ、読み手は探しても見つからない注を探します。逆に、本文のどこも指さない注は、どの語の注か分かりません。注を消したり番号を振り直したりして、印と注の片方だけが残ったときに起きます。印と注の番号を突き合わせれば、機械で言えます。
+  en: When the text says "[^3]" or "※3" and there is no note 3, the reader looks for a note that is not there; a note nothing points to cannot be tied to any word. It happens when a note is deleted or the notes are renumbered and only one side is changed. Matching the marks against the notes' numbers is mechanical.
+
+message:
+  ja: 「{label}」の注がありません
+  en: 'There is no note for "{label}"'
+
+messages:
+  missing:
+    ja: 「{label}」の注がありません
+    en: 'There is no note for "{label}"'
+  unused:
+    ja: 注「{label}」を本文のどこも指していません
+    en: 'Nothing in the text points to the note "{label}"'
+
+how_to_fix:
+  ja: 注を足すか、印を消してください。注を振り直したなら、本文の印も同じ番号に直します。
+  en: Add the note or remove the mark. If the notes were renumbered, renumber the marks to match.
+
+levels: { normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 本文の「※3」「[^3]」に対応する注が無い所と、本文のどこも指さない注
+  en: A note mark ("[^3]", "※3") with no note, or a note that nothing in the text points to
+example:
+  ja:
+    before: |
+      営業運行※1を開始し、料金※2は無料です。
+
+      ※1 特定の走行環境条件での運行
+    after: |
+      営業運行※1を開始し、料金※2は無料です。
+
+      ※1 特定の走行環境条件での運行
+      ※2 実証期間中に限ります
+  en:
+    before: |
+      The pilot starts in May[^1] and is free[^2].
+
+      [^1]: On weekdays only.
+    after: |
+      The pilot starts in May[^1] and is free[^2].
+
+      [^1]: On weekdays only.
+      [^2]: During the trial period.
+
+not_flagged:
+  ja: Markdown の脚注（[^1] と行頭の [^1]:）と、※ に一桁か二桁の番号を付けた印（※1、（※2））を読みます。※ の注が文書に一つも無いときは、注を別の所（表や別紙）に置いた文書と読んで言いません。※ の後ろに数が続くもの（※2018年度）は注の番号ではありません。コードの中は読みません。
+  en: Markdown footnotes ([^1] and a line starting "[^1]:") and a ※ with a one- or two-digit number (※1, (※2)) are read. When a document has no ※ note at all, its notes are taken to be elsewhere (a table, an annex) and nothing is reported for ※. A ※ before a longer number ("※2018") is not a note mark. Code is not read.
+
+rewrite:
+  ja:
+    direction: 印と注の番号を突き合わせ、注の無い印には注を足すか印を消し、どこからも指されない注には印を足すか注を消してください。
+    pairs:
+      - before: 料金※2は無料です。（注は ※1 だけ）
+        after: 料金※2は無料です。（※2 実証期間中に限ります、を足す）
+      - before: 本文に ※3 が無いのに「※3 予約が必要です」の注がある
+        after: 予約の要る語に ※3 を付ける
+    keep:
+      - 注の中身
+      - ほかの注の番号
+    avoid:
+      - 書き手が知らない注の中身を作る
+      - 印だけを消して、注が要る内容を本文から落とす
+  en:
+    direction: Match the marks against the notes. Add the missing note or remove its mark; for a note nothing points to, add the mark where it belongs or remove the note.
+    pairs:
+      - before: The pilot is free[^2]. (only [^1] is defined)
+        after: 'The pilot is free[^2]. (adds "[^2]: During the trial period.")'
+      - before: '"[^3]: Booking required." with no [^3] in the text'
+        after: '"Booking is required[^3]." where the note belongs'
+    keep:
+      - what each note says
+      - the numbers of the other notes
+    avoid:
+      - inventing what a note says
+      - removing a mark and with it a qualification the text needs

package/rules/heading-end-punctuation-mix.yaml

@@ -0,0 +1,158 @@
+id: heading-end-punctuation-mix
+layer: L1
+status: stable
+how_to_find: heading-end-punctuation
+word_list: heading-end-word
+requires: [markdown]
+severity: info
+
+name:
+  ja: 見出しの終わりの記号が揃っていない
+  en: Heading end punctuation mixed
+
+why:
+  ja: ほとんどの見出しが「手順」「注意点」のように記号なしで終わるのに、一つだけ「準備：」「確認。」と記号で終わっていたり、その逆だったりすると、読み手はその見出しだけ別の扱いなのかと迷い、目次でも浮いて見えます。直し忘れや、別の文書から貼った見出しによく出る形です。どちらの書き方が正しいかは決めず、同じ深さの見出しのうち少ないほうを指します。深さごとに比べるので、一段深い見出しをすべて「任意：」のような札にする書き方は指しません。
+  en: When most headings end bare ("Setup", "Notes") and one ends with a colon or a full stop ("Prerequisites:", "Checks."), or the other way round, the reader wonders whether that heading is meant to be different, and it stands out in the table of contents. It is usually a heading pasted from elsewhere or not yet tidied. chaff does not pick a style; it points at the smaller side among headings of the same depth. Depths are compared apart, so a depth whose headings are all labels ("Optional:") is not reported.
+
+message:
+  ja: 見出し「{heading}」の終わりの記号が、ほかの見出し（「{example}」など {count} 個）と違います
+  en: 'The heading "{heading}" ends differently from the other headings ("{example}" and {count} in all)'
+messages:
+  marked:
+    ja: 見出し「{heading}」だけ「{mark}」で終わっています（ほかの見出しは「{example}」など {count} 個が「：」「。」なしで終わる）
+    en: 'The heading "{heading}" ends with "{mark}", while {count} other headings end bare ("{example}")'
+  bare:
+    ja: 見出し「{heading}」だけ「：」「。」なしで終わっています（ほかの見出しは「{example}」など {count} 個が記号で終わる）
+    en: 'The heading "{heading}" ends bare, while {count} other headings end with a mark ("{example}")'
+
+how_to_fix:
+  ja: 見出しの終わりを、多いほうの書き方に揃えてください。記号なしの見出しが多ければ「：」や「。」を外します。
+  en: End the heading the way most headings end. If most end bare, drop the colon or the full stop.
+
+placeholders:
+  heading:
+    ja: 見出し
+    en: the heading
+  mark:
+    ja: 記号
+    en: the mark
+  example:
+    ja: ほかの見出し
+    en: another heading
+  count:
+    ja: 〇
+    en: N
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 記号なしの見出しの中に「準備：」「確認。」のように記号で終わる見出しが混ざっている所（またはその逆）
+  en: A heading ending with a colon or a full stop among headings that end bare, or the other way round
+example:
+  ja:
+    before: |
+      # 作業の手引き
+
+      ## 準備
+
+      道具をそろえます。
+
+      ## 手順
+
+      順に進めます。
+
+      ## 確認：
+
+      結果を見ます。
+
+      ## 片付け
+
+      元に戻します。
+    after: |
+      # 作業の手引き
+
+      ## 準備
+
+      道具をそろえます。
+
+      ## 手順
+
+      順に進めます。
+
+      ## 確認
+
+      結果を見ます。
+
+      ## 片付け
+
+      元に戻します。
+  en:
+    before: |
+      # Working guide
+
+      ## Preparation
+
+      Gather the tools.
+
+      ## Steps
+
+      Work through them in order.
+
+      ## Checks:
+
+      Look at the result.
+
+      ## Cleanup
+
+      Put everything back.
+    after: |
+      # Working guide
+
+      ## Preparation
+
+      Gather the tools.
+
+      ## Steps
+
+      Work through them in order.
+
+      ## Checks
+
+      Look at the result.
+
+      ## Cleanup
+
+      Put everything back.
+
+not_flagged:
+  ja: 文書の題（最初の一つだけの一番上の見出し）は比べません。同じ深さの見出しが四つ未満の所、記号で終わる見出しと終わらない見出しが同じくらいある文書（少ないほうが四分の一を超える）は指しません。疑問符・感嘆符で終わる見出しは、記号なしと数えます。「…」や「etc.」「Inc.」のように言葉の一部の点で終わる見出しは比べません（点で終わる略語は言語ごとの語彙表にあります）。
+  en: The page title (a single top-level heading that opens the document) is not compared. Fewer than four headings at one depth, or where both ways are common (the smaller side above a quarter), is not reported. A heading ending with a question mark or an exclamation mark counts as bare. A heading ending with a full stop that is part of the words ("…", "etc.", "Inc.") is left out of the comparison; the abbreviations are in each language's lexicon.
+rewrite:
+  depth: light
+  ja:
+    direction: 見出しの終わりを、文書の多くの見出しと同じ書き方にしてください。記号を足すか外すだけで、見出しの言葉は変えません。
+    pairs:
+      - before: 「## 準備」「## 手順」「## 確認：」
+        after: 「## 準備」「## 手順」「## 確認」
+      - before: 「## 背景。」「## 方針。」「## 課題」
+        after: 「## 背景。」「## 方針。」「## 課題。」
+    keep:
+      - 見出しの言葉と深さ
+    avoid:
+      - 少ないほうに合わせて、ほかの見出しをすべて書き換える
+      - 見出しを文に書き直す
+  en:
+    direction: End the heading the way most of the document's headings end. Only add or drop the mark; keep the heading's words.
+    pairs:
+      - before: '"## Preparation", "## Steps", "## Checks:"'
+        after: '"## Preparation", "## Steps", "## Checks"'
+      - before: '"## Background.", "## Plan.", "## Risks"'
+        after: '"## Background.", "## Plan.", "## Risks."'
+    keep:
+      - the heading's words and depth
+    avoid:
+      - rewriting every other heading to match the odd one
+      - turning the heading into a sentence

package/rules/less-for-fewer.yaml

@@ -0,0 +1,59 @@
+id: less-for-fewer
+layer: L3
+status: stable
+how_to_find: amount-for-count
+requires: [pos]
+languages: [en]
+extra_word_lists: [amount-quantifier, invariant-noun, finite-auxiliary]
+severity: info
+
+name:
+  ja: 数えられる名詞に less
+  en: '"Less" with a countable plural'
+
+why:
+  ja: 英語の書き言葉では、量には less、数には fewer を使います（less time、fewer errors）。「less errors」「less people」は話し言葉ではよく聞きますが、改まった文書では誤りと読まれます。直後の名詞が数えられる複数とはっきり読める所だけを指します。名詞や数の後ろの less は「引く」の意味（revenue less costs）なので指しません。
+  en: 'Written English uses "less" for an amount and "fewer" for a count ("less time", "fewer errors"). "Less errors" and "less people" are common in speech, but a formal reader takes them as a slip. Only a "less" directly before a noun that reads clearly as a countable plural is reported. "Less" after a noun or a number means "minus" ("revenue less costs") and is not reported.'
+
+message:
+  ja: 「{word}」は数を言うので「{suggestion}」と書きます
+  en: '"{word}" counts things; write "{suggestion}"'
+
+how_to_fix:
+  ja: 数えられる名詞の複数の前では fewer を使ってください（less errors → fewer errors）。量を言いたいなら、名詞を量の語に替えてください（less work）。
+  en: Use "fewer" before a countable plural ("less errors" becomes "fewer errors"). To speak of an amount, use a word for the amount ("less work").
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  literature: 'A narrator and a character speak as they speak: "less people" in dialogue is the voice.'
+  speech: "A transcript keeps the speaker's words."
+
+group: slips
+summary:
+  ja: 英語で、「less errors」のように数えられる名詞の複数に less を付けた所
+  en: '"Less" before a countable plural, as in "less errors", where written English uses "fewer"'
+example:
+  en:
+    before: The new parser reports less errors on long files.
+    after: The new parser reports fewer errors on long files.
+
+not_flagged:
+  ja: 量の名詞（less time、less work）、形容詞に付く less（less experienced staff）、「引く」の less（revenue less costs、$500 less fees）、less than、単数と複数が同じ綴りの名詞（less data）は指しません。
+  en: 'Mass nouns ("less time", "less work"), "less" before an adjective ("less experienced staff"), "less" meaning minus ("revenue less costs", "$500 less fees"), "less than", and nouns spelled alike in both numbers ("less data") are not reported.'
+
+rewrite:
+  depth: light
+  en:
+    direction: Replace "less" with "fewer" before the countable plural. Change only that word.
+    pairs:
+      - before: The new parser reports less errors on long files.
+        after: The new parser reports fewer errors on long files.
+      - before: We hired less people in the spring.
+        after: We hired fewer people in the spring.
+    keep:
+      - the noun and the rest of the sentence
+      - '"less" before an amount ("less time") or meaning minus ("revenue less costs")'
+    avoid:
+      - turning every "less" into "fewer", including amounts