chaffjs 0.18.0 → 0.20.0

package/rules/paragraph-restatement.yaml

@@ -0,0 +1,96 @@
+id: paragraph-restatement
+layer: L2
+status: experimental
+how_to_find: paragraph-restatement
+requires: [pos]
+severity: info
+
+name:
+  ja: 前の段落を言い直すだけの段落
+  en: A paragraph that only restates the one before
+
+why:
+  ja: 「つまり」「このように」「言い換えれば」で始まる段落が、すぐ前の段落と同じ語ばかりで書かれていると、読み手は同じことを二度読むことになります。まとめは、前の段落に無いこと（結論、次に何をするか、数字）を足してはじめて役に立ちます。chaff は、言い直しを告げる語（語彙表）で始まる段落の内容語（名詞・動詞・形容詞・副詞・数）のうち、前の段落にすでにある語の割合を数えます。
+  en: When a paragraph opens with "In other words" or "In short" and then uses mostly the words of the paragraph before it, the reader reads the same thing twice. A summary helps only when it adds something the paragraph before did not say (the conclusion, what to do next, a figure). chaff counts, for a paragraph that opens with a restating word (from the lexicon), the share of its content words (nouns, verbs, adjectives, adverbs, numbers) already in the paragraph before.
+
+message:
+  ja: 「{opener}」で始まるこの段落は、内容語の {share}% が前の段落の繰り返しです
+  en: 'This paragraph opens with "{opener}" and {share}% of its content words repeat the paragraph before'
+
+how_to_fix:
+  ja: 段落を消して、前の段落で言い切ってください。まとめが要るなら、前の段落に無いこと（結論、次の一手、数字）を書きます。
+  en: Cut the paragraph and let the one before stand. If a summary is needed, make it say what the paragraph before did not (the conclusion, the next step, a figure).
+
+# 言い直しを告げる語で始まる段落の内容語のうち、前の段落にある語の割合（パーセント）。これ以上で指摘。
+levels: { strict: 40, normal: 50, relaxed: 60 }
+
+use_for: [blog, business, technical, docs, academic, legal, literature, speech]
+
+group: readability
+summary:
+  ja: 「つまり」「このように」で始まり、前の段落の語をほとんど繰り返すだけの段落
+  en: A paragraph that opens with "In other words" or "In short" and mostly repeats the paragraph before
+
+example:
+  ja:
+    config: { genre: blog/tech }
+    before: |
+      新しい在庫システムでは、店舗の在庫を一つの画面で数えられます。棚卸しの時間も短くなります。
+
+      このように、新しい在庫システムでは店舗の在庫を一つの画面で数えられ、棚卸しの時間が短くなります。
+    after: |
+      新しい在庫システムでは、店舗の在庫を一つの画面で数えられます。棚卸しの時間も短くなります。
+
+      来月から全店で使い始め、最初の棚卸しは 4 月 10 日です。
+  en:
+    config: { genre: blog/tech }
+    before: |
+      The new inventory system counts every store's stock on one screen, and a stocktake takes less time.
+
+      In other words, the new inventory system counts the stock of every store on one screen, so a stocktake takes less time.
+    after: |
+      The new inventory system counts every store's stock on one screen, and a stocktake takes less time.
+
+      Every store switches next month, and the first stocktake is on April 10.
+
+not_flagged:
+  ja: 言い直しを告げる語で始まらない段落、内容語が 4 つに満たない段落、見出し・箇条書き・表・コードを挟んだ段落は見ません。前の段落の語の割合だけを見るので、まとめが前の数段落を受けていても、すぐ前の段落と比べます。法務・文学・話し言葉のジャンルでは見ません。
+  en: 'A paragraph that does not open with a restating word, one with fewer than four content words, and one separated from the paragraph before by a heading, a list, a table or code are not checked. Words that open other sentences too ("That is why", "Again the drums") count only with a comma after them ("That is,"). Legal, literary and speech genres do not run this rule.'
+level_meaning:
+  ja: 内容語の {limit}% 以上が前の段落の繰り返しのとき指摘
+  en: reported when {limit}% or more of the paragraph's content words repeat the paragraph before
+rewrite:
+  ja:
+    direction: 言い直しの段落を消すか、前の段落に無いことを書く段落に変えてください。結論・次にすること・数字のうち、本文にあるものを書きます。「つまり」「このように」で前の段落をなぞるだけの文は残しません。
+    pairs:
+      - before: |
+          このように、新しい在庫システムでは店舗の在庫を一つの画面で数えられ、棚卸しの時間が短くなります。
+        after: |
+          来月から全店で使い始め、最初の棚卸しは 4 月 10 日です。
+      - before: |
+          つまり、申込書は月末までに出す必要があり、遅れると受け付けられません。
+        after: |
+          郵送の場合は、月末の消印まで有効です。
+    keep:
+      - 前の段落の中身
+      - 本文にある日付・数字・名前
+    avoid:
+      - 本文に無い事実を足す
+      - 前の段落を別の言い方でもう一度書く
+  en:
+    direction: Cut the restating paragraph, or turn it into one that says what the paragraph before did not. Use the conclusion, the next step or a figure the text gives. Do not keep a sentence that only walks over the previous paragraph again after "In other words".
+    pairs:
+      - before: |
+          In other words, the new inventory system counts the stock of every store on one screen, so a stocktake takes less time.
+        after: |
+          Every store switches next month, and the first stocktake is on April 10.
+      - before: |
+          In short, the form must reach us by the end of the month, or it will not be accepted.
+        after: |
+          A posted form counts if it is postmarked by the last day of the month.
+    keep:
+      - what the paragraph before says
+      - the dates, figures and names in the text
+    avoid:
+      - adding a fact the text does not have
+      - saying the paragraph before again in other words

package/rules/person-consistency.yaml

@@ -0,0 +1,59 @@
+id: person-consistency
+layer: L2
+status: experimental
+how_to_find: person-mix
+word_list: person-word
+extra_word_lists: [person-form]
+severity: info
+
+name:
+  ja: 自分や読み手の呼び方が揃っていない
+  en: The document names itself or its reader two ways
+
+why:
+  ja: 文書が自分を「私たち」と呼ぶか「弊社」「当社」と呼ぶか、書き手を「私」と書くか「筆者」と書くか、英語で読み手を you と呼ぶか one と呼ぶかは文体の選択で、どれが正しいかは決めません。一つの文書の中で混ざると、読み手は話し手が変わったのか、別の誰かのことなのかを考えます。継ぎ合わせた文書や、別の人が足した段落によく起きます。chaff は呼び方ごとに文書の中で多いほうを文書の書き方とし、少ないほうを指します。鉤括弧と引用符の中、引用の段落、コードは数えません。英語の we と I は、多くの文書で別の相手（組織と話し手）を指すので比べません。
+  en: Whether a Japanese document calls itself 私たち or 弊社 and its writer 私 or 筆者, and whether an English document addresses its reader as "you" or as "one", is a choice of voice, and chaff does not pick one. Mixed in one document, the reader wonders whether the speaker changed or someone else is meant; it happens most where text was stitched together or another writer added a paragraph. chaff takes the form the document uses most as its habit and points at the other. Quotations, quoted blocks and code are not counted. English "we" and "I" are not compared, since in most documents they name two parties (the organisation and the speaker).
+
+message:
+  ja: 「{matched}」と書いています（この文書はふつう「{usual}」。{of} 箇所のうち {count} 箇所が違う）
+  en: '"{matched}" here, where the document usually says "{usual}" ({count} of {of})'
+
+placeholders:
+  matched:
+    ja: 見つけた呼び方
+    en: the form found
+  usual:
+    ja: 文書でふつうの呼び方
+    en: the form the document usually uses
+
+how_to_fix:
+  ja: 同じ相手を指しているなら、文書の多いほうの呼び方に揃えてください。別の相手（会社と、書き手個人）を指しているなら、その違いが読み手に分かるように書きます。
+  en: If the same party is meant, use the form the rest of the document uses. If another party is meant (the company and the writer), make the difference clear to the reader.
+
+# 少ないほうの呼び方が、その呼び方全体の何パーセントまでなら混ざりと見るか。超えたら、文書が使い分けている。
+levels: { strict: 30, normal: 20, relaxed: 10 }
+
+use_for: [technical, blog, business, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 「私たち」と「弊社」、「私」と「筆者」のように、一つの文書が自分や読み手を二通りに呼んでいる所
+  en: 'One document naming itself two ways (私たち and 弊社) or its reader two ways ("you" and "one")'
+example:
+  ja:
+    before: |
+      弊社は、来月から新しい窓口を開きます。弊社の担当者が、平日の午前に受け付けます。私たちは、相談の内容を記録に残します。弊社は、記録を一年間保管します。保管した記録は、弊社の外には出しません。
+    after: |
+      弊社は、来月から新しい窓口を開きます。弊社の担当者が、平日の午前に受け付けます。弊社は、相談の内容を記録に残します。弊社は、記録を一年間保管します。保管した記録は、弊社の外には出しません。
+  en:
+    before: |
+      You can book a slot online. Your booking shows on the next page. If you miss it, you can book again. One can also call the desk.
+    after: |
+      You can book a slot online. Your booking shows on the next page. If you miss it, you can book again. You can also call the desk.
+
+not_flagged:
+  ja: 呼び方が一通りの文書と、少ないほうが決まった割合を超える文書（使い分けていると見ます）は指摘しません。多いほうが 3 箇所に満たない文書も見ません。鉤括弧と引用符の中、引用の段落、コード、前後に漢字やカタカナが続く語（東京本社、当社比）は数えません。英語の one は、can や must の前の主語の one だけを数え、no one や the one や前置詞の後ろの one は数えません。どの呼び方が正しいかは決めません。
+  en: A document with one form, or whose other form passes a set share of the places (it uses both on purpose), is not reported, nor one whose usual form appears fewer than 3 times. Quotations, quoted blocks, code and words joined to longer ones (東京本社) are not counted. Only "one" as the subject of a modal verb is counted, not "no one", "the one" or "one" after a preposition. Which form is right is not decided.
+level_meaning:
+  ja: 少ないほうの呼び方が全体の {limit} パーセント以下のとき指摘
+  en: reported when the other form is {limit} percent of the places or fewer

package/rules/preferred-term.yaml

@@ -31,6 +31,7 @@ placeholders:
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+sources: [plain-2011, kyodo-2022]
 
 group: team
 summary:

package/rules/proper-noun-density.yaml

@@ -15,14 +15,18 @@ why:
   en: A run of product, company and person names hides the shape of the sentence from anyone who does not already know them. It reads fine to the person who wrote it.
 
 message:
-  ja: 1000 語あたり {density} 個の固有名詞があります（{limit} 個まで）
+  ja: 1000 字あたり {density} 個の固有名詞があります（{limit} 個まで）
   en: "{density} proper {density|noun|nouns} per 1000 words (limit {limit})"
 
 how_to_fix:
   ja: 2 度目からは「その製品」「そのチーム」のように受けてください。初出で何者かを一言添えると、知らない人も読めます。
   en: After first use, refer back to it. One phrase saying what it is lets a stranger keep reading.
 
-levels: { strict: 20, normal: 40, relaxed: 80 }
+# 英語は 1000 語あたり。英語の人の書いた文書（コーパスと Project Gutenberg の小説・随筆）で測ると、名前の多さの分布の
+# 95 パーセンタイルあたりに normal を置く。測り方とその値は PR に残した（数字はここに書かない）。
+levels:
+  ja: { strict: 20, normal: 40, relaxed: 80 }
+  en: { strict: 150, normal: 200, relaxed: 260 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
 
@@ -39,15 +43,20 @@ example:
     after: |
       営業部の二人が、取引先三社の展示を見てから、大阪で別の取引先の担当者と会いました。翌日は関西の二社を回り、名古屋に戻って取引先二社に報告しました。
   en:
+    config: { rules: { proper-noun-density: strict } }
     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.
+      Alice Moreno and Bob Tanaka from Contoso met Carol Diaz from Fabrikam in Seattle, then flew with Dave Okafor from Northwind to Boston to see Erin Walsh at Tailspin and Frank Liu at Litware.
+      In Chicago, Grace Kim of Proseware and Henry Park of Wingtip joined Ivan Petrov of Adatum, and Julia Rossi of Contoso brought Kevin Shah of Fabrikam.
+      From Denver, Laura Chen of Northwind and Mark Evans of Tailspin called Nina Alvarez of Litware, Oscar Grant of Proseware and Paula Novak of Wingtip.
     after: |
       Two of our sales team met three customers on the West Coast, then flew to Boston to meet two more.
+      In Chicago, three partners joined them, and our account lead brought a fourth.
+      From Denver, two of the team called the remaining customers.
 
 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
+  ja: 1000 字あたり固有名詞 {limit} 個まで
+  en: up to {limit} proper nouns per 1000 words

package/rules/ra-nuki.yaml

@@ -0,0 +1,43 @@
+id: ra-nuki
+layer: L2
+status: experimental
+how_to_find: ra-nuki
+# 一段動詞かどうかは品詞解析で読む。品詞が無ければ動かない。
+requires: [pos]
+languages: [ja]
+severity: warning
+
+name:
+  ja: ら抜き言葉
+  en: Potential form without ra
+
+why:
+  ja: 一段動詞とカ変動詞の可能の形は「られる」です（見られる・食べられる・来られる）。「見れる」「食べれる」「来れる」は話し言葉では広く使われますが、書き言葉では誤りと読まれます。五段動詞の可能の形（走れる・帰れる）は正しいので指しません。どの動詞が一段動詞かは品詞解析で読みます。鉤括弧や引用符で引いた言葉（話した言葉をそのまま引いたもの）は数えません。話し言葉と文学のジャンルでは既定で止めています。
+  en: The potential form of an ichidan verb or of 来る takes られる (見られる, 食べられる, 来られる). 見れる, 食べれる and 来れる are common in speech but read as mistakes in writing. The potential of a godan verb (走れる, 帰れる) is correct and is not reported. Which verbs are ichidan is read by the morphological analyser. Words quoted in brackets or quotation marks (speech quoted as spoken) are not counted. The speech and literature presets turn it off.
+
+message:
+  ja: 「{matched}」は「ら」の抜けた形です
+  en: '"{matched}" drops the ら of the potential form'
+
+how_to_fix:
+  ja: 「ら」を入れてください（見れる → 見られる、食べれる → 食べられる、来れる → 来られる）。
+  en: Put the ら back (見れる → 見られる, 食べれる → 食べられる, 来れる → 来られる).
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: wording
+summary:
+  ja: 「見れる」「食べれる」「来れる」のような、ら抜き言葉
+  en: A Japanese potential form without ら, such as 見れる for 見られる
+example:
+  ja:
+    before: |
+      資料は明日から見れます。
+    after: |
+      資料は明日から見られます。
+
+not_flagged:
+  ja: 五段動詞の可能の形（走れる・帰れる）、鉤括弧や引用符で引いた言葉は指しません。話し言葉と文学のジャンルでは既定で止めています。
+  en: The potential of godan verbs (走れる, 帰れる) and quoted words are not reported. The speech and literature presets turn it off.

package/rules/redundant-expression.yaml

@@ -0,0 +1,76 @@
+id: redundant-expression
+layer: L2
+status: experimental
+how_to_find: phrase-match
+word_list: redundant-expression
+uses: [pos]
+severity: info
+
+name:
+  ja: 重言
+  en: Redundant pair
+
+why:
+  ja: 「頭痛が痛い」「一番最初」「後で後悔する」のように同じ意味の語を重ねると、読み手は二度目の語に意味を探してつまずき、書き手が言葉を選んでいないように読めます。重ねを外しても意味は変わりません。言い回しの一覧は言語ごとの語彙表にあり、それぞれに重ねを外した形が付いています。辞書が一語として載せる慣用（排気ガス、射程距離）は数えません。
+  en: Two words that say the same thing ("end result", "each and every", "revert back") make the reader look for a meaning in the second word that is not there, and read as unedited. Dropping the repeat changes nothing. The pairs are listed in each language's lexicon, each with the form to use instead. Idioms that are sometimes needed ("whether or not", "period of time") are not counted.
+
+message:
+  ja: 「{matched}」は同じ意味の語を重ねています
+  en: '"{matched}" says the same thing twice'
+
+how_to_fix:
+  ja: 重ねた語の一方を消してください（一番最初 → 最初、後で後悔する → 後悔する）。
+  en: Drop the repeat ("end result" → "result", "revert back" → "revert").
+
+# 何回あれば指摘するか。1 は一つ目から。
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: wording
+summary:
+  ja: 「頭痛が痛い」「一番最初」「後で後悔」のような、同じ意味の語の重なり
+  en: Two words that say the same thing, such as "end result" or "each and every"
+example:
+  ja:
+    before: |
+      一番最初に、手順を確認してください。
+    after: |
+      最初に、手順を確認してください。
+  en:
+    before: |
+      The end result is a shorter build.
+    after: |
+      The result is a shorter build.
+
+not_flagged:
+  ja: 辞書が一語として載せる慣用（排気ガス、射程距離、製造メーカー）、重ねて強める書き方として定着したもの（犯罪を犯す、あらかじめ予約）は指しません。文学のジャンルでは既定で止めています。
+  en: Idioms that are sometimes needed ("whether or not", "period of time", "past experience", "plan ahead") are not reported. The literature preset turns it off.
+level_meaning:
+  ja: 重言を含む文が {limit} 文あれば指摘
+  en: reported once {limit} sentences hold one
+rewrite:
+  ja:
+    direction: 重ねた語の一方を消して、一度だけ言ってください。語彙表の語ごとの書き換え（一番最初 → 最初）に従い、文のほかの所は変えません。
+    pairs:
+      - before: 一番最初に、手順を確認してください。
+        after: 最初に、手順を確認してください。
+      - before: 返事を返すまでに三日かかりました。
+        after: 返事をするまでに三日かかりました。
+    keep:
+      - 文の意味と語順
+      - 重ねていない語
+    avoid:
+      - 重ねを外すついでに文を書き換える
+  en:
+    direction: Drop one of the two words that say the same thing, following the lexicon's replacement for the phrase ("end result" → "result"). Leave the rest of the sentence alone.
+    pairs:
+      - before: The end result is a shorter build.
+        after: The result is a shorter build.
+      - before: We reverted back to the old schema.
+        after: We reverted to the old schema.
+    keep:
+      - what the sentence says
+      - the words around the pair
+    avoid:
+      - rewriting the whole sentence while dropping the repeat

package/rules/reference-title-mismatch.yaml

@@ -0,0 +1,101 @@
+id: reference-title-mismatch
+layer: L3
+status: experimental
+how_to_find: reference-title-mismatch
+requires: [structure]
+severity: warning
+
+name:
+  ja: 参照に添えた名前が、参照先の見出しと違う
+  en: A reference whose name does not match its target's heading
+
+why:
+  ja: 「第5条（秘密保持）」の第5条が、実は「第5条（損害賠償）」だと、読み手は番号と名前のどちらを信じればよいか分かりません。条や章を足したり消したりして番号がずれたのに、参照を直し忘れると起きます。参照のすぐ後ろの括弧か引用符の中の名前を、参照先の見出しと比べます。どちらかがどちらかを含めば合っているとみなします。
+  en: 'When "Section 5 (Confidentiality)" points at a Section 5 headed "Liability", the reader cannot tell whether the number or the name is right. It happens when sections are added or removed and the numbers shift, but the references are not updated. The name in brackets or quotes right after a reference is compared with the target''s heading; they agree when either contains the other.'
+
+message:
+  ja: "{label}に「{name}」と添えていますが、{label}の見出しは「{heading}」です"
+  en: '{label} is called "{name}" here, but its heading is "{heading}"'
+
+how_to_fix:
+  ja: 番号と名前のどちらが正しいかを確かめて、もう一方を直してください。番号がずれたのなら、ほかの参照も同じようにずれていないかを見てください。
+  en: Check whether the number or the name is right and correct the other. If the numbers shifted, check the other references too.
+
+levels: { normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 「第5条（秘密保持）」のように参照に添えた名前が、その条や章の見出しと違う所
+  en: A name given with a reference ("Section 5 (Confidentiality)") that differs from that section's heading
+example:
+  ja:
+    before: |
+      # 規約
+
+      ## 第1章 総則
+
+      料金は第2章「返金」を見てください。
+
+      ## 第2章 料金
+
+      月額です。
+    after: |
+      # 規約
+
+      ## 第1章 総則
+
+      料金は第2章「料金」を見てください。
+
+      ## 第2章 料金
+
+      月額です。
+  en:
+    before: |
+      # Terms
+
+      ## 1. Scope
+
+      For fees, see Section 2 (Refunds).
+
+      ## 2. Pricing
+
+      The fee is monthly.
+    after: |
+      # Terms
+
+      ## 1. Scope
+
+      For fees, see Section 2 (Pricing).
+
+      ## 2. Pricing
+
+      The fee is monthly.
+
+not_flagged:
+  ja: 参照先が見出しを持たないとき、参照先が一つに決まらないとき、他の文書の条（民法第709条）、括弧の中が数字を含むか「前述」「参照」のような語のときは見ません。
+  en: References whose target has no heading or cannot be told apart, references to another document, and brackets holding a number or a word like "above" or "see" are left alone.
+rewrite:
+  ja:
+    direction: 番号と名前のどちらが正しいかを書き手に確かめ、もう一方を直してください。名前を添える意味が無ければ、名前を消して番号だけにしてもかまいません。
+    pairs:
+      - before: 第2章「返金」を見てください。
+        after: 第2章「料金」を見てください。
+      - before: 第5条（秘密保持）に定めるとおり
+        after: 第6条（秘密保持）に定めるとおり
+    keep:
+      - 参照先の番号と見出しの対応
+    avoid:
+      - どちらが正しいかを推測で決める
+  en:
+    direction: Ask the writer whether the number or the name is right, and correct the other. If the name adds nothing, the reference can carry the number alone.
+    pairs:
+      - before: see Section 2 (Refunds)
+        after: see Section 2 (Pricing)
+      - before: as set out in Section 5 (Confidentiality)
+        after: as set out in Section 6 (Confidentiality)
+    keep:
+      - which numbered section has which heading
+    avoid:
+      - guessing which value is right

package/rules/reference-topic-missing.yaml

@@ -0,0 +1,101 @@
+id: reference-topic-missing
+layer: L3
+status: experimental
+how_to_find: reference-topic-missing
+requires: [structure]
+severity: info
+
+name:
+  ja: 「第2章で述べた〇〇」の〇〇が、第2章に無い
+  en: A reference to a topic its target never mentions
+
+why:
+  ja: 「第2章で述べた料金体系」と書いたのに、第2章に料金体系の話が無いと、読み手は探しても見つけられません。章を入れ替えたり、話を別の章へ移したりしたときに起きます。参照のすぐ後ろの「で述べた」「で説明した」に続く語を、参照先の見出しと本文から探し、どこにも無ければ指します。
+  en: 'When the text says "see Section 2 for pricing" and Section 2 never mentions pricing, the reader looks and finds nothing. It happens when sections are reordered or a topic moves elsewhere. The words right after "for" (or 「で述べた」) are looked for in the target''s heading and text, and it is pointed out when they are not there.'
+
+message:
+  ja: "{label}（{heading}）に「{topic}」が見当たりません"
+  en: '"{topic}" does not appear in {label} ({heading})'
+
+how_to_fix:
+  ja: 話がどの章にあるかを確かめて、参照の番号を直してください。言い換えて書いているなら、同じ言葉に揃えると読み手が探せます。
+  en: Find the section that covers the topic and correct the number. If the section words it differently, using the same word lets the reader find it.
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 「第2章で述べた料金体系」のように参照先の話題を書いたのに、その章に話題の語が無い所
+  en: A reference that names a topic ("see Section 2 for pricing") its target never mentions
+example:
+  ja:
+    before: |
+      # 案内
+
+      ## 第1章 総則
+
+      第2章で述べた返金手続は改定されます。
+
+      ## 第2章 料金
+
+      料金体系は月額です。
+    after: |
+      # 案内
+
+      ## 第1章 総則
+
+      第2章で述べた料金体系は改定されます。
+
+      ## 第2章 料金
+
+      料金体系は月額です。
+  en:
+    before: |
+      # Guide
+
+      ## 1. Scope
+
+      See Section 2 for refunds.
+
+      ## 2. Pricing
+
+      The price is monthly.
+    after: |
+      # Guide
+
+      ## 1. Scope
+
+      See Section 2 for pricing.
+
+      ## 2. Pricing
+
+      The price is monthly.
+
+not_flagged:
+  ja: 「詳細」「内容」のようにどの章にも当てはまる語、参照先が見出しを持たないか一つに決まらない参照、他の文書の条は見ません。言い換え（料金と価格）は見つけられないので、語が違えば指します。
+  en: Words that fit any section ("details", "more information"), references whose target has no heading or cannot be told apart, and references to another document are left alone. A synonym (price and fee) is not recognised, so a different word is pointed out.
+rewrite:
+  ja:
+    direction: 話題がどの章にあるかを書き手に確かめ、参照の番号を直してください。参照先が別の言葉で書いているなら、どちらかの言葉に揃えます。
+    pairs:
+      - before: 第2章で述べた返金手続は改定されます。
+        after: 第3章で述べた返金手続は改定されます。
+      - before: 第2章で述べた価格表
+        after: 第2章で述べた料金表
+    keep:
+      - 参照している話題
+    avoid:
+      - 参照先に無い話を、参照先にあることにする
+  en:
+    direction: Ask the writer which section covers the topic and correct the number. If the target words it differently, use one wording in both places.
+    pairs:
+      - before: See Section 2 for refunds.
+        after: See Section 3 for refunds.
+      - before: See Section 2 for fees.
+        after: See Section 2 for pricing.
+    keep:
+      - the topic being referred to
+    avoid:
+      - claiming the target covers something it does not

package/rules/relative-date-mismatch.yaml

@@ -0,0 +1,71 @@
+id: relative-date-mismatch
+layer: L3
+status: experimental
+how_to_find: relative-date-mismatch
+requires: [dates]
+severity: warning
+
+name:
+  ja: 「3日後の10月5日」の日付が、基準の日付から数えた日と合わない
+  en: A relative date that does not match its base date
+
+why:
+  ja: 「10月2日に申し込み、3日後の10月6日に通知」のように、相対の期間と日付を一緒に書くと、読み手はどちらが正しいのか分かりません。日程をずらしたときに、日付か期間の片方だけを直すと起きます。「3日後の」「1か月前の」のすぐ後ろの日付を、同じ文で前にある日付（文が「2週間後、」で始まるなら前の文の日付）に期間を足した（前なら引いた）日と比べます。
+  en: 'When a relative length and a date are written together ("Applications open on May 1, 2026. Two weeks later, on May 16, 2026, …"), the reader cannot tell which is right. It happens when a schedule moves and only the date or only the length is changed. The date right after "N days later" or "N weeks earlier" is compared with the nearest earlier date in the same sentence (or in the previous sentence when the sentence opens with the relative length), plus or minus the length.'
+
+message:
+  ja: "{base}の{relative}なら{expected}のはずですが、{target}と書かれています"
+  en: "{relative} from {base} is {expected}, but the date is given as {target}"
+
+how_to_fix:
+  ja: 基準の日付・期間・日付のどれが正しいかを確かめて、残りを合わせてください。
+  en: Check which is right, the base date, the length or the date, and make the rest agree.
+
+levels: { normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 「3日後の10月6日」のように、相対で書いた日付が基準の日付から数えた日と合わない所
+  en: A date written with a relative length ("two weeks later, on May 16") that is not that far from its base date
+example:
+  ja:
+    before: |
+      10月2日に申し込みを締め切り、3日後の10月6日に結果を通知します。
+    after: |
+      10月2日に申し込みを締め切り、3日後の10月5日に結果を通知します。
+  en:
+    before: |
+      Applications close on May 1, 2026. Two weeks later, on May 16, 2026, results are sent.
+    after: |
+      Applications close on May 1, 2026. Two weeks later, on May 15, 2026, results are sent.
+
+not_flagged:
+  ja: 期間のすぐ後ろ（「の」や読点だけを挟む）に日付があるときだけ見ます。基準の日付が同じ文（文の頭の「2週間後、」なら前の文）に無いもの、「3営業日後」のように単位が日・週・月・年でないものは見ません。
+  en: Only a date right after the relative length (with "on" or punctuation between) is checked. A relative length with no date before it in the same sentence (or the previous one, when the sentence opens with it), and units other than days, weeks, months and years ("3 business days later"), are left alone.
+rewrite:
+  ja:
+    direction: 基準の日付・期間・日付のどれが正しいかを書き手に確かめ、残りを合わせてください。期間か日付のどちらかを消して、一つだけにしてもかまいません。
+    pairs:
+      - before: 10月2日に締め切り、3日後の10月6日に通知します。
+        after: 10月2日に締め切り、3日後の10月5日に通知します。
+      - before: 発売日の5月1日の1か月前の4月2日に予約を始めます。
+        after: 発売日の5月1日の1か月前の4月1日に予約を始めます。
+    keep:
+      - 基準の日付
+      - 「後」か「前」かの向き
+    avoid:
+      - どれが正しいかを推測で決める
+  en:
+    direction: Ask the writer which of the base date, the length and the date is right, and make the rest agree. Dropping either the length or the date also works.
+    pairs:
+      - before: Applications close on May 1, 2026. Two weeks later, on May 16, 2026, results are sent.
+        after: Applications close on May 1, 2026. Two weeks later, on May 15, 2026, results are sent.
+      - before: The launch is on June 1, 2026; one month earlier, on May 2, 2026, preorders open.
+        after: The launch is on June 1, 2026; one month earlier, on May 1, 2026, preorders open.
+    keep:
+      - the base date
+      - whether the date is later or earlier
+    avoid:
+      - guessing which value is right