chaffjs 0.28.0 → 0.29.0

package/rules/announced-count-mismatch.yaml

@@ -9,13 +9,18 @@ name:
   en: A list that does not have the number of items announced
 
 why:
-  ja: 「以下の3点」と書いたのに、すぐ下の箇条書きが2つや4つだと、読み手は抜けた項目があるのか、数え間違いなのかを確かめることになります。項目を足したり消したりしたあとに、予告の数を直し忘れると起きます。箇条書きのすぐ前の文が、「以下の」「次の」のような先を指す語か、終わりのコロン（：）と一緒に数（3点、2つ、4項目）を書いているときだけ、その数を箇条書きのいちばん外側の項目の数と比べます。
-  en: When a sentence says "the following three steps" and the list right below it has two or four, the reader has to check whether an item is missing or the count is wrong. It happens when an item is added or removed and the count is not updated. The number is compared with the items at the top level of the list only when the sentence right before the list announces it, with a word pointing ahead ("following", "below") or a colon at its end, and the number names what the list holds ("three steps", "two reasons").
+  ja: 「以下の3点」と書いたのに、すぐ下の箇条書きが2つや4つだと、読み手は抜けた項目があるのか、数え間違いなのかを確かめることになります。項目を足したり消したりしたあとに、予告の数を直し忘れると起きます。箇条書きのすぐ前の文が、「以下の」「次の」のような先を指す語か、終わりのコロン（：）と一緒に数（3点、2つ、4項目）を書いているときだけ、その数を箇条書きのいちばん外側の項目の数と比べます。「出席者（6名）：田中、鈴木、…」のように、ラベルの後ろの括弧に数を書き、コロンの後ろに読点やコンマで区切って名前を並べた行も、括弧の数と並べた名前の数を比べます。
+  en: 'When a sentence says "the following three steps" and the list right below it has two or four, the reader has to check whether an item is missing or the count is wrong. It happens when an item is added or removed and the count is not updated. The number is compared with the items at the top level of the list only when the sentence right before the list announces it, with a word pointing ahead ("following", "below") or a colon at its end, and the number names what the list holds ("three steps", "two reasons"). A line with a count in brackets after a label and names after the colon, split at commas ("Attendees (6): Tanaka, Suzuki, ..."), is checked the same way: the count against the names listed.'
 
 message:
   ja: 「{phrase}」と予告していますが、すぐ下の箇条書きは{listed}項目です
   en: '"{phrase}" is announced, but the number of items in the list below is {listed}'
 
+messages:
+  inline:
+    ja: 「{phrase}」と書いていますが、後ろに区切って並べたのは{listed}つです
+    en: '"{phrase}" is given, but {listed} are listed after it'
+
 how_to_fix:
   ja: 項目が抜けていないか確かめて、足りなければ足し、数が違うなら予告の数を直してください。
   en: Check whether an item is missing. Add it, or correct the number in the announcement.
@@ -55,5 +60,5 @@ example:
       - Your bank account
 
 not_flagged:
-  ja: 目安の数（約3点、3つ以上）、順番（3つ目）、選ぶ数（以下から1つ選ぶ）、見出しや表の前の数、箇条書きがすぐ後ろに無い数は比べません。予告の文に数が二つあるときも比べません。コロンだけで予告する文は、コロンにいちばん近い数を予告の数とみなし、その数の後ろにまだ数があれば比べません（「1 つのページを 2 ページに分けました:」）。どの行も「ラベル：A / B」の形の箇条書きは、斜線（/）で区切って並べた項目の数が合っていれば指摘しません。
-  en: An estimate (about three, three or more), a rank (the first three), how many to pick (choose two), a number before a heading or a table, and a number with no list right after it are not compared. Nor is a sentence with two numbers in it. When only a colon announces the list, the number nearest the colon is the count, so a number followed by another one is not compared ("We merged three tasks into 2 pages:"). A list whose every item is a label, a colon and members split at slashes is not reported when the members add up to the count.
+  ja: 目安の数（約3点、3つ以上）、順番（3つ目）、選ぶ数（以下から1つ選ぶ）、見出しや表の前の数、箇条書きがすぐ後ろに無い数は比べません。予告の文に数が二つあるときも比べません。コロンだけで予告する文は、コロンにいちばん近い数を予告の数とみなし、その数の後ろにまだ数があれば比べません（「1 つのページを 2 ページに分けました:」）。どの行も「ラベル：A / B」の形の箇条書きは、斜線（/）で区切って並べた項目の数が合っていれば指摘しません。一行に並べた名前は、区切りが決まらないとき（名前の中に「と」「・」がある、括弧が閉じていない、途中で文が終わる）と、並びが閉じていないとき（「ほか」「など」で終わる、「5名ほか」）は比べません。
+  en: An estimate (about three, three or more), a rank (the first three), how many to pick (choose two), a number before a heading or a table, and a number with no list right after it are not compared. Nor is a sentence with two numbers in it. When only a colon announces the list, the number nearest the colon is the count, so a number followed by another one is not compared ("We merged three tasks into 2 pages:"). A list whose every item is a label, a colon and members split at slashes is not reported when the members add up to the count. Names listed on one line are not compared when the split is unclear ("and" or "&" inside a name, an unclosed bracket, a sentence ending midway) or the list is left open ("etc.", "and others").

package/rules/arrival-before-departure.yaml

@@ -0,0 +1,48 @@
+id: arrival-before-departure
+layer: L3
+status: stable
+how_to_find: arrival-before-departure
+requires: [dates]
+severity: warning
+
+name:
+  ja: 着が発より前
+  en: An arrival before its departure
+
+why:
+  ja: 「福岡 11:30発、羽田 11:05着」のように、同じ便や列車の着の時刻が発より前だと、どちらかの時刻を書き間違えています。読み手は乗る便を確かめ直すことになり、間違ったまま予定を組む人も出ます。同じ行の発と着（時刻のすぐ後ろの「発」「着」、表の出発と到着の列）を比べます。着に翌日の印（翌、+1）があれば一日足し、発と着の両方に日付があれば日付から比べます。
+  en: 'When a leg such as "departs Washington 1:30 PM, arrives Boston 1:05 PM" arrives before it departs, one of the times is wrong. The reader has to look the connection up again, and someone may plan around the wrong time. A departure and an arrival in one line are compared: times marked "departs" and "arrives" (or "dep" and "arr"), and the departure and arrival columns of a table. An arrival marked as the next day (+1, "next day") gets a day added, and when both times have a date, the dates are compared first.'
+
+message:
+  ja: 着「{arrival}」が発「{departure}」より前です
+  en: "Arrives at {arrival}, before it departs at {departure}"
+
+how_to_fix:
+  ja: 発と着の時刻を確かめて、書き間違えたほうを直してください。日をまたぐなら、着に「翌」や「+1」を書いてください。
+  en: Check both times and correct the wrong one. If the leg arrives on the next day, mark the arrival "+1" or "next day".
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+
+group: facts
+summary:
+  ja: 旅程の便や列車で、着の時刻が発の時刻より前の所
+  en: A flight or a train in an itinerary that arrives before it departs
+example:
+  ja:
+    before: |
+      - 11:30 JAL 316便（福岡 11:30発、羽田 11:05着）
+    after: |
+      - 11:30 JAL 316便（福岡 11:30発、羽田 13:05着）
+  en:
+    before: |
+      - 1:30 PM Flight AA 2177 (departs Washington 1:30 PM, arrives Boston 1:05 PM)
+    after: |
+      - 1:30 PM Flight AA 2177 (departs Washington 1:30 PM, arrives Boston 3:05 PM)
+
+not_flagged:
+  ja: 着に翌日の印（翌、+1）のあるもの、片方にだけ日付のあるもの、違う時間帯の印が二つあるものや「現地時間」の付いたもの（時刻をそのまま比べられない）は言いません。
+  en: 'An arrival marked as the next day (+1, "next day"), a pair where only one time has a date, and a line with two different time zones or a "local time" mark (the times cannot be compared as written) are not reported.'

package/rules/connective-hierarchy.yaml

@@ -3,7 +3,7 @@ layer: L2
 status: stable
 how_to_find: connective-hierarchy
 word_list: connective-hierarchy
-extra_word_lists: [connective-lookalike]
+extra_word_lists: [connective-lookalike, connective-clause-end]
 requires: [pos]
 languages: [ja]
 severity: warning
@@ -43,8 +43,8 @@ example:
       申請書及び添付書類を提出する。
 
 not_flagged:
-  ja: 日本語の文書だけで動きます。仮名の「ならびに」「もしくは」は、普通の文で一段の並べ方にも使われるので見ません。「及び」「および」「又は」「または」が同じ文にあれば、段の組を作ったと読みます。「」『』の中は、引いた語句の片方だけなので見ません。名詞の後ろで名詞をつなぐときだけ見ます（文字の並びに、正しい並びに、縦並びには見ません）。
-  en: Only in Japanese documents. The kana forms ならびに and もしくは, which plain writing also uses for a one-level list, are not read. A sentence holding 及び, および, 又は or または is read as having the other level. A phrase inside 「」 or 『』 quotes half of a list and is not read. Only a word joining two nouns is read (文字の並びに, 正しい並びに and 縦並びに, the noun 並び with に, are not).
+  ja: 日本語の文書だけで動きます。仮名の「ならびに」「もしくは」は、普通の文で一段の並べ方にも使われるので見ません。「及び」「および」「又は」「または」が同じ節にあれば、段の組を作ったと読みます（条件の節「…ときは、」と主の節は別の節です）。「」『』の中は、引いた語句の片方だけなので見ません。名詞の後ろで名詞をつなぐときだけ見ます（文字の並びに、正しい並びに、縦並びには見ません）。
+  en: Only in Japanese documents. The kana forms ならびに and もしくは, which plain writing also uses for a one-level list, are not read. A clause holding 及び, および, 又は or または is read as having the other level (a condition clause ending in ときは、 and the main clause are separate clauses). A phrase inside 「」 or 『』 quotes half of a list and is not read. Only a word joining two nouns is read (文字の並びに, 正しい並びに and 縦並びに, the noun 並び with に, are not).
 sources: [koyobun-2022]
 rewrite:
   depth: light

package/rules/currency-notation-consistency.yaml

@@ -9,8 +9,8 @@ name:
   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.
+  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. Amounts in table cells are counted too.
 
 message:
   ja: 「{written}」と書いています（この文書はこの通貨をふつう「{usual}」のように書きます。{of} 箇所のうち {count} 箇所が違う）

package/rules/date-order.yaml

@@ -10,13 +10,18 @@ name:
   en: A date out of order in a schedule
 
 why:
-  ja: 旅程やマイルストーンのように日付を並べた箇条書きや表で、ひとつだけ前の日付より早い日付があると、書き間違いか順番の入れ替わりかを読み手が確かめることになります。並びが古い順か新しい順かは多いほうで決め、それに逆らう日付だけを指します。その向きに沿う日付が半分以下の並びは、名前や版の順に並べた一覧として扱い、何も言いません。
-  en: In a list or a table of dates, such as an itinerary or milestones, one date earlier than the one before it makes the reader check whether it is a typo or a swapped row. The direction of the list (oldest or newest first) is taken from most of its steps, and only a date against it is pointed out. A list where no more than half of the dates follow that direction is taken as sorted by something else, such as a name or a version, and nothing is said.
+  ja: 旅程やマイルストーンのように日付を並べた箇条書きや表、変更履歴の版ごとの見出しのように同じ深さに並ぶ見出しで、ひとつだけ前の日付より早い日付があると、書き間違いか順番の入れ替わりかを読み手が確かめることになります。並びが古い順か新しい順かは多いほうで決め、それに逆らう日付だけを指します。その向きに沿う日付が半分以下の並びは、名前や版の順に並べた一覧として扱い、何も言いません。
+  en: In a list or a table of dates, such as an itinerary or milestones, or in a run of headings at one depth, such as the release headings of a changelog, one date earlier than the one before it makes the reader check whether it is a typo or a swapped row. The direction of the list (oldest or newest first) is taken from most of its steps, and only a date against it is pointed out. A list where no more than half of the dates follow that direction is taken as sorted by something else, such as a name or a version, and nothing is said.
 
 message:
   ja: 「{date}」が、前後の日付の並びから外れています（前は「{previous}」）
   en: "{date} breaks the order of the dates around it (after {previous})"
 
+messages:
+  first:
+    ja: 「{date}」が、後の日付の並びから外れています（次は「{next}」）
+    en: "{date} breaks the order of the dates after it (before {next})"
+
 how_to_fix:
   ja: 日付を確かめて、書き間違いなら直し、順番が違うなら並べ替えてください。
   en: Check the date. Correct it if it is a typo, or move the row if the order is wrong.
@@ -30,8 +35,8 @@ sources: [de-marneffe-2008]
 
 group: facts
 summary:
-  ja: 旅程や予定表で、一つだけ日付の順番が前後している所
-  en: One date out of order in an itinerary or a schedule
+  ja: 旅程や予定表、変更履歴の見出しで、一つだけ日付の順番が前後している所
+  en: One date out of order in an itinerary, a schedule or a changelog's headings
 example:
   ja:
     before: |

package/rules/date-outside-period.yaml

@@ -0,0 +1,64 @@
+id: date-outside-period
+layer: L3
+status: stable
+how_to_find: date-outside-period
+requires: [dates]
+severity: warning
+
+name:
+  ja: 書いた期間の外の日付
+  en: A date outside the stated period
+
+why:
+  ja: 「旅行期間：10月12日〜10月15日」と書いた旅程の中に10月17日の予定があると、期間と日程のどちらが正しいのかを読み手が問い合わせることになります。日付を書き写し間違えたときや、日程を動かして期間を直し忘れたときに起きます。期間は「旅行期間」「会期」のような期間の語で始まる一行から読み、その後ろの同じ節の箇条書き、表の行、見出しの日付と、地の文の年の無い日付を比べます。前泊や事後の予定、申込締切や予約の日、過去の回のように、期間の外に置く語がその行や文、節の見出しにある日付は比べません。年の無い期間（12月28日〜1月4日）は年をまたぐ期間として読みます。
+  en: 'When an itinerary says "Trip dates: Oct 12–15" and then lists something on October 17, the reader has to ask whether the period or the schedule is right. It happens when a date is copied wrong, or when the schedule moves and the period is not updated. The period is read from one line that starts with a period word such as "Trip dates" or "Conference", and the dates after it in the same section are compared, in list items, table rows and headings, and in running text when the date has no year. A date whose item, sentence or section heading marks it as outside the period on purpose (a post-trip meeting, a booking deadline, a past edition) is not compared. A period without a year ("Dec 28 – Jan 4") is read as running into the new year.'
+
+message:
+  ja: 「{date}」が、書いた期間「{period}」の外です
+  en: '{date} is outside the stated period "{period}"'
+
+how_to_fix:
+  ja: 日付と期間を確かめて、書き間違えたほうを直してください。期間の前後に置く予定なら、前泊、事後のようにそう分かる書き方にしてください。
+  en: Check the date and the period, and correct the one that is wrong. If the item is meant to fall before or after the period, say so ("pre-trip", "follow-up").
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+
+group: facts
+summary:
+  ja: 旅程や会期のように書いた期間の外にある、日程の日付
+  en: A dated item outside the period the document states, such as a trip's or a conference's dates
+example:
+  ja:
+    before: |
+      旅行期間：2026年10月12日〜2026年10月15日
+
+      - 10月12日 成田を出発
+      - 10月14日 市内視察
+      - 10月17日 成田に帰着
+    after: |
+      旅行期間：2026年10月12日〜2026年10月15日
+
+      - 10月12日 成田を出発
+      - 10月14日 市内視察
+      - 10月15日 成田に帰着
+  en:
+    before: |
+      Conference: May 3–5, 2026
+
+      - May 3: registration and keynote
+      - May 4: workshops
+      - May 7: closing session
+    after: |
+      Conference: May 3–5, 2026
+
+      - May 3: registration and keynote
+      - May 4: workshops
+      - May 5: closing session
+
+not_flagged:
+  ja: 期間を書いていない文書、期間の外に置く語（前泊、事後、申込締切、予約、前回）のある日付、年の無い期間が年をまたぐときの年明けの日付は比べません。
+  en: 'A document with no stated period, a date marked as outside on purpose ("post-trip", "follow-up", "book by", "deadline", "previous"), and the new-year dates of a period without a year that runs past December 31 are not compared.'

package/rules/default-value-mismatch.yaml

@@ -0,0 +1,79 @@
+id: default-value-mismatch
+layer: L1
+status: stable
+how_to_find: default-values
+# A default column's header (Default, 既定値) and a default stated in prose (defaults to, の既定値は) come from the
+# default-header and default-phrase lexicons.
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 既定値を二通りに書いている
+  en: Default value stated two ways
+
+why:
+  ja: "シグネチャが width = 72 なのに説明が「`width` の既定値は 80」だと、読み手は指定しなかったときの動きを読み違えます。既定値を変えたときに、コードか表か文のどれかだけを直すと起きます。宣言の引数の既定値（width = 72）、見出しが「既定値」の列の値、「`width` の既定値は」の後ろの値を集め、同じ名前の値がコード、表、文の順でいちばん確かなものと違うとき、違うほうを指します。"
+  en: 'When the signature says width = 72 and the text says "`width` defaults to 80", the reader misjudges what happens when the option is left out. It happens when a default changes and only the code, the table or the text is updated. The defaults in a declaration (width = 72), in a column headed Default, and after "`width` defaults to" are collected. When a name''s value differs from its most authoritative statement (code, then a table, then a sentence), the differing one is pointed out.'
+
+message:
+  ja: 「{name}」の既定値を「{value}」と書いていますが、ほかの所では「{expected}」です
+  en: "The default of `{name}` is given as {value} here, but as {expected} elsewhere"
+
+how_to_fix:
+  ja: 実際の既定値を確かめて、違うほうを直してください。
+  en: Check the real default, and correct the statement that differs.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [technical, docs, blog, legal, academic, literature, speech]
+off_for:
+  legal: "Signatures and option tables belong to technical writing."
+  academic: "Signatures and option tables belong to technical writing."
+  literature: "Signatures and option tables belong to technical writing."
+  speech: "Signatures and option tables belong to technical writing."
+
+group: facts
+summary:
+  ja: 引数やオプションの既定値が、シグネチャ・表・文で食い違う所
+  en: A parameter's default that differs between the signature, a table and the text
+example:
+  ja:
+    config: { genre: technical/readme }
+    before: |
+      ## wrap
+
+      ```ts
+      wrap(text: string, width = 72): string[]
+      ```
+
+      `width` の既定値は 80 文字です。
+    after: |
+      ## wrap
+
+      ```ts
+      wrap(text: string, width = 72): string[]
+      ```
+
+      `width` の既定値は 72 文字です。
+  en:
+    config: { genre: technical/readme }
+    before: |
+      ## wrap
+
+      ```ts
+      wrap(text: string, width = 72): string[]
+      ```
+
+      `width` defaults to 80 characters.
+    after: |
+      ## wrap
+
+      ```ts
+      wrap(text: string, width = 72): string[]
+      ```
+
+      `width` defaults to 72 characters.
+
+not_flagged:
+  ja: 呼び出しで渡した値（wrap(text, width=40)）、コードの印で囲んでいない名前、既定値を言う語から離れた値、同じ重さの二つの文や二つのコード（別の関数が同じ名前の引数に違う既定値を持つ）が食い違うだけのものは見ません。複数行に分けたシグネチャ、ハイフンの付いた名前（--max-width）、行の頭に | の無い表、値が言い方の途中にある英語の文（`x` is true by default）は読みません。
+  en: "A value passed in a call (wrap(text, width=40)), a name not in code marks, a value away from the default phrase, and a disagreement only between statements of the same weight (two functions giving one parameter name different defaults) are not checked. A signature split over several lines, names with dashes (--max-width), tables whose rows do not start with |, and sentences with the value inside the phrase (`x` is true by default) are not read."

package/rules/defined-term-form.yaml

@@ -10,8 +10,8 @@ name:
   en: A defined term used in another form
 
 why:
-  ja: 契約では、定義した語は定義した形のまま使うのが決まりです。「本サービス」と定義したあとで「「本サービス」」とかぎ括弧を付け直すと、新しく定義し直したのか、同じものなのかが読み手に分かりません。英語では "Services" と定義した語を "services" と小文字で書くと、定義した意味なのか、ふつうの意味なのかが分かれ、争いのもとになります。「本業務」と定義して「本件業務」と書くと、別の業務を指すのかと読めます。定義の後ろで、かぎ括弧や引用符に入れ直した語、大文字で定義した語を小文字で書いた所（大文字の使用より少ないとき）、頭の「本」と「本件」を入れ替えた語（その形も定義した語なら除きます）を指します。
-  en: 'A contract uses each defined term exactly as defined. Quoting a term again after its definition ("the "Services"") leaves the reader asking whether it is being defined anew. Writing "services" where "Services" is defined splits the defined sense from the ordinary one, which is where disputes start. In Japanese, 本件業務 written where 本業務 is defined reads as another task. chaff points at a term set in quotes again after its definition, at a capitalised term written in lower case (when the capitalised uses are more), and at a Japanese term written with its other prefix (本 for 本件 or the other way round), unless that form is defined too.'
+  ja: 契約では、定義した語は定義した形のまま使うのが決まりです。「本サービス」と定義したあとで「「本サービス」」とかぎ括弧を付け直すと、新しく定義し直したのか、同じものなのかが読み手に分かりません。英語では "Services" と定義した語を "services" と小文字で書くと、定義した意味なのか、ふつうの意味なのかが分かれ、争いのもとになります。「本業務」と定義して「本件業務」と書くと、別の業務を指すのかと読めます。「管理責任者」と定義して「文書管理責任者」と書くと、定義した者なのか別の者なのかが分かりません。定義の後ろで、かぎ括弧や引用符に入れ直した語、大文字で定義した語を小文字で書いた所（大文字の使用より少ないとき）、頭の「本」と「本件」を入れ替えた語（その形も定義した語なら除きます）、定義の文の語を足して長くした語（文書管理責任者、App と定義した後の Application）を指します。法令・規程でも、定義した語は定義の形のまま使います。
+  en: 'A contract uses each defined term exactly as defined. Quoting a term again after its definition ("the "Services"") leaves the reader asking whether it is being defined anew. Writing "services" where "Services" is defined splits the defined sense from the ordinary one, which is where disputes start. In Japanese, 本件業務 written where 本業務 is defined reads as another task. "the Application" written where the Pinecone Notes application is defined as the "App" leaves the reader asking whether it is the same thing. chaff points at a term set in quotes again after its definition, at a capitalised term written in lower case (when the capitalised uses are more, "records officer" for "Records Officer" too), at a Japanese term written with its other prefix (本 for 本件 or the other way round) unless that form is defined too, and at a term made longer with a word of its own definition (Application for App, 文書管理責任者 for 管理責任者). Statutes and regulations use their defined terms as defined, too.'
 
 message:
   ja: 定義した「{term}」と違う形で使っています
@@ -27,6 +27,9 @@ messages:
   prefix:
     ja: 「{term}」は {line} 行目で定義した語ですが、ここは「{written}」と書いています
     en: '"{term}" is defined on line {line}, but written "{written}" here'
+  extended:
+    ja: 「{term}」は {line} 行目で定義した語ですが、ここは定義の文の語を足して「{written}」と書いています
+    en: '"{term}" is defined on line {line}, but written "{written}" here, longer with a word of its definition'
 
 how_to_fix:
   ja: 定義した語はかぎ括弧を付けずに使い、英語では定義のとおり大文字で始めてください。ふつうの意味で使うなら、別の言葉に替えます。
@@ -40,12 +43,11 @@ off_for:
   academic: "Defined terms and short names are a contract's apparatus: the legal genres check them."
   literature: "Defined terms and short names are a contract's apparatus: the legal genres check them."
   speech: "Defined terms and short names are a contract's apparatus: the legal genres check them."
-  legal/statute: "A regulation's guidelines and circulars quote a defined term to point at its definition (「個人情報」の定義)."
 
 group: consistency
 summary:
-  ja: 契約や規約で、定義した語を定義のあとでかぎ括弧に入れ直したり、大文字で定義した語を小文字で書いたり、「本業務」を「本件業務」と書いたりしている所
-  en: A defined term quoted again after its definition, a capitalised defined term written in lower case, or a Japanese term with its other prefix (本件業務 for 本業務)
+  ja: 契約・規約・規程で、定義した語を定義のあとでかぎ括弧に入れ直したり、大文字で定義した語を小文字で書いたり、「本業務」を「本件業務」と書いたり、「管理責任者」を「文書管理責任者」と長くしたりしている所
+  en: A defined term quoted again after its definition, a capitalised defined term written in lower case, a Japanese term with its other prefix (本件業務 for 本業務), or a term made longer with a word of its definition (Application for App)
 example:
   ja:
     config: { genre: legal/contract }
@@ -81,8 +83,8 @@ example:
       3. You must not resell the Services.
 
 not_flagged:
-  ja: 定義そのもの（以下「本サービス」という、「本サービス」とは）、定義より前の使用（use-before-definition が見ます）、文の頭の大文字、小文字の使用が {limit} 個を超えるか大文字の使用より多い語（ふつうの意味で使っているとみなす）は指しません。定義の文の中の使用（「顧客」とは、表紙に「顧客」と書いた者をいう）も見ません。法令・規程のジャンルは、定義を指すために語をかぎ括弧に入れるので見ません。「本」と「本件」を入れ替えた形は、その形も定義した語であるとき、長い語の一部（見本物品）のときは見ません。
-  en: 'The definitions themselves ("Services" means, (the "Services")), uses before the definition (use-before-definition reads those), capitals at the start of a sentence, and terms written in lower case more than {limit} times or more often than capitalised (taken as the ordinary word used on purpose) are not reported, nor is a use inside the defining sentence ("Customer" means the party named "Customer"). Statutes and regulations quote a term to point at its definition, so that genre does not run this rule. A term with its other prefix (本件業務 for 本業務) is not reported when that form is defined too, or inside a longer word (見本物品).'
+  ja: 定義そのもの（以下「本サービス」という、「本サービス」とは）、定義より前の使用（use-before-definition が見ます）、文の頭の大文字、小文字の使用が {limit} 個を超えるか大文字の使用より多い語（ふつうの意味で使っているとみなす）は指しません。定義の文の中の使用（「顧客」とは、表紙に「顧客」と書いた者をいう）も見ません。法令・規程（statute の profile で読む文書）は、語そのものを指すために語をかぎ括弧に入れる（「株主」とあるのは、「個人情報」の定義）ので、かぎ括弧に入れ直した語は指しません。小文字の語句は、形容詞で始まるもの、形容詞や所有の語が前に付くもの（its own confidential information、additional terms of service）は普通の語句として見ません。「本」と「本件」を入れ替えた形は、その形も定義した語であるとき、長い語の一部（見本物品）のときは見ません。長くした語は、指す語（当該・前記・同・各）が前に付いただけのもの、二字以下の語（提供、登録）を長くしたもの、定義の文がその長い語を書いているもの（東京都（以下「都」という。））、その長い語も定義した語であるもの、複数形（Boxes）は見ません。
+  en: 'The definitions themselves ("Services" means, (the "Services")), uses before the definition (use-before-definition reads those), capitals at the start of a sentence, and terms written in lower case more than {limit} times or more often than capitalised (taken as the ordinary word used on purpose) are not reported, nor is a use inside the defining sentence ("Customer" means the party named "Customer"). A statute or a regulation (a document read with the statute profile) quotes a term to talk about the term itself ("controller" has the same meaning as in Part 3), so a quoted term is not reported there. A lower-case phrase that starts with an adjective, or that an adjective or a possessive comes before (its own confidential information, additional terms of service), is the ordinary phrase and is not reported. A term with its other prefix (本件業務 for 本業務) is not reported when that form is defined too, or inside a longer word (見本物品). A longer word is not reported when only a pointing word comes before the term (当該管理責任者), when the term has two characters or fewer (提供, 登録), when the definition itself writes the longer word (東京都（以下「都」という。）), when the longer word is defined too, or when it is a plural (Boxes).'
 level_meaning:
   ja: 小文字の使用が {limit} 個以下で、大文字の使用より少ないとき指摘
   en: lower-case uses reported when they are {limit} or fewer and fewer than the capitalised ones

package/rules/deprecated-option-used.yaml

@@ -0,0 +1,78 @@
+id: deprecated-option-used
+layer: L1
+status: stable
+how_to_find: deprecated-use
+# The words that mark a name deprecated (deprecated, 非推奨) come from the deprecation-word lexicon.
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 非推奨と書いた名前をコード例で使っている
+  en: Deprecated name used in an example
+
+why:
+  ja: "「`indent` は非推奨です」と書いた同じ文書のコード例が `{ indent: 2 }` を使っていると、読み手は例をそのまま写して、やがて動かなくなる書き方を覚えます。オプションを非推奨にしたときに、説明だけを直して例を直し忘れると起きます。文の中で「非推奨」「deprecated」にいちばん近いコードの名前と、それらの語のある表の行の最初の列の名前を非推奨の名前として読み、コードブロックの中でその名前をキー（indent:）、引数（indent=）、フラグ（--indent）として使っている行を指します。"
+  en: 'When a document says "`indent` is deprecated" and one of its code examples passes `{ indent: 2 }`, the reader copies the example and learns a form that will stop working. It happens when an option is deprecated and the text is updated but the example is not. The code name nearest to "deprecated" in a sentence, and the name in the first cell of a table row that says "deprecated", are read as deprecated. A code-block line that uses one as a key (indent:), an argument (indent=) or a flag (--indent) is pointed out.'
+
+message:
+  ja: 非推奨と書いた「{name}」を、コード例で使っています
+  en: "`{name}` is used in an example, but the document calls it deprecated"
+
+how_to_fix:
+  ja: 例を、非推奨の名前の代わりになるものを使う書き方に直してください。古い書き方を見せる例なら、その行に非推奨とコメントしてください。
+  en: Rewrite the example with what replaces the deprecated name. If the example shows the old form on purpose, say so in a comment on that line.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [technical, docs, blog, legal, academic, literature, speech]
+off_for:
+  legal: "Code examples and option tables belong to technical writing."
+  academic: "Code examples and option tables belong to technical writing."
+  literature: "Code examples and option tables belong to technical writing."
+  speech: "Code examples and option tables belong to technical writing."
+
+group: facts
+summary:
+  ja: 非推奨と書いたオプションを、同じ文書のコード例がまだ使っている所
+  en: An option the document calls deprecated, still used in one of its examples
+example:
+  ja:
+    config: { genre: technical/readme }
+    before: |
+      ## オプション
+
+      以前の `indent` オプションは非推奨です。代わりに `prefix` を使ってください。
+
+      ```js
+      wrap(text, 40, { indent: 2 });
+      ```
+    after: |
+      ## オプション
+
+      以前の `indent` オプションは非推奨です。代わりに `prefix` を使ってください。
+
+      ```js
+      wrap(text, 40, { prefix: "  " });
+      ```
+  en:
+    config: { genre: technical/readme }
+    before: |
+      ## Options
+
+      The older `indent` option is deprecated; use `prefix` instead.
+
+      ```js
+      wrap(text, 40, { indent: 2 });
+      ```
+    after: |
+      ## Options
+
+      The older `indent` option is deprecated; use `prefix` instead.
+
+      ```js
+      wrap(text, 40, { prefix: "  " });
+      ```
+
+not_flagged:
+  ja: 「非推奨ではない」のように打ち消した語、API を宣言するコードブロック（interface、class、type）、その行に非推奨と書いたコード（古い書き方を見せる例）、名前をキー・引数・フラグ以外で書いたもの（文字列の中、メンバーの読み出し obj.indent）、コードの外の文、コードで書いていない名前は見ません。
+  en: "A negated word (not deprecated), a block that declares an API (interface, class, type), a code line that says deprecated itself (an example of the old form), a name used other than as a key, an argument or a flag (inside a string, a member read obj.indent), sentences outside code, and names not written as code are not checked."

package/rules/doubled-nado.yaml

@@ -4,24 +4,24 @@ status: stable
 how_to_find: phrase-match
 word_list: doubled-nado
 requires: [pos]
-languages: [ja]
+languages: [ja, en]
 severity: warning
 
 name:
   ja: 「など」と「等」の重ね
-  en: など and 等 doubled
+  en: '"And so on" said twice'
 
 why:
-  ja: 「書類等など」「申請など等」のように「など」と「等」を重ねても、どちらも「ほかにもある」と言うだけで、意味は増えません。読み手には書き損じに見えます。組は言語ごとの語彙表にあります。
-  en: In Japanese, など and 等 both mean "and so on"; writing them together (書類等など) adds nothing and reads as a slip. The pairs are listed in the lexicon.
+  ja: 「書類等など」「申請など等」のように「など」と「等」を重ねても、どちらも「ほかにもある」と言うだけで、意味は増えません。読み手には書き損じに見えます。英語の「and etc.」も、etc.（et cetera）がもう「and」を含むので同じ重ねです。組は言語ごとの語彙表にあります。
+  en: '"Etc." is et cetera, "and the rest", so "and etc." says "and" twice; in Japanese, など and 等 both mean "and so on", and 書類等など doubles them. Either adds nothing and reads as a slip. The pairs are listed in the lexicon.'
 
 message:
-  ja: 「{matched}」は、「など」と「等」を重ねています
-  en: '"{matched}" doubles など and 等'
+  ja: 「{matched}」は、「ほかにもある」を二度言っています
+  en: '"{matched}" says "and so on" twice'
 
 how_to_fix:
-  ja: どちらか一つにしてください（書類等など → 書類など）。
-  en: Keep one of the two (書類等など → 書類など).
+  ja: どちらか一つにしてください（書類等など → 書類など、and etc. → etc.）。
+  en: Keep one of the two ("and etc." → "etc.", 書類等など → 書類など).
 
 levels: { strict: 1, normal: 1, relaxed: 2 }
 
@@ -29,17 +29,22 @@ use_for: [business, technical, blog, legal, docs, academic, literature, speech]
 
 group: slips
 summary:
-  ja: 「書類等など」のように、「など」と「等」を重ねた所
-  en: など and 等, both "and so on", written together in Japanese
+  ja: 「書類等など」「and etc.」のように、「ほかにもある」を言う語を重ねた所
+  en: '"And etc." or など with 等: two words for "and so on" written together'
 example:
   ja:
     before: |
       申請書等などを提出してください。
     after: |
       申請書などを提出してください。
+  en:
+    before: |
+      Bring pens, paper and etc. to the workshop.
+    after: |
+      Bring pens, paper, etc. to the workshop.
 not_flagged:
-  ja: 一覧にある組だけを見ます。「などなど」は話し言葉の強めなので数えません。
-  en: Only the pairs on chaff's list. などなど, a spoken intensifier, is not counted.
+  ja: 一覧にある組だけを見ます。「などなど」は話し言葉の強めなので数えません。英語の「such as A, B, etc.」のように間に語を挟んだ重ねは、一つの言い回しとして見られないので見ません。
+  en: Only the pairs on chaff's list. などなど, a spoken intensifier, is not counted. "Such as A, B, etc.", where words come between the two, cannot be matched as one phrase and is not checked.
 level_meaning:
   ja: 重ねた所が {limit} 箇所あれば指摘
   en: reported once there are {limit}
@@ -56,3 +61,14 @@ rewrite:
       - 並べた項目
     avoid:
       - 項目を足して「など」を言い換える
+  en:
+    direction: Drop the extra "and" (or "and so on") and keep "etc.". Change nothing else.
+    pairs:
+      - before: Bring pens, paper and etc. to the workshop.
+        after: Bring pens, paper, etc. to the workshop.
+      - before: We cover travel, meals, etc. and so on.
+        after: We cover travel, meals, etc.
+    keep:
+      - the listed items
+    avoid:
+      - adding items to replace "etc."

package/rules/due-before-issue.yaml

@@ -0,0 +1,68 @@
+id: due-before-issue
+layer: L3
+status: stable
+how_to_find: due-date
+# The issue-date and due-date words come from the language's issue-date-label and due-date-label lexicons; the words of
+# minutes from minutes-title-word, meeting-date-label, action-section-heading, earlier-section-word, action-due-label and item-done-word.
+requires: [dates]
+languages: [ja, en]
+severity: error
+
+name:
+  ja: 期限が発行日より前
+  en: A due date before the issue date
+
+why:
+  ja: 請求書の「お支払期限」や見積書の「有効期限」が「発行日」より前だと、受け取った時点で期限が過ぎていることになり、読み手はどちらの日付が正しいのかを問い合わせることになります。前の月の請求書を使い回して、片方の日付だけ直したときに起きます。発行日の語で始まる行と期限の語で始まる行の日付を比べ、期限が発行日より前なら指します。議事録の宿題も同じで、会議の日（日時）より前の期限は、会議の時点で過ぎています。宿題の節の、期限の列の日付や「（期限 11月2日）」を、頭の方の「日時」の日付と比べます。
+  en: When the payment due date of an invoice or the expiry of a quote is before its issue date, the document is overdue on arrival and the reader has to ask which date is right. It happens when last month's invoice is reused and only one date is changed. The date on a line starting with an issue word (Issued, Invoice date) is compared with the date on a line starting with a due word (Payment due, Valid until), and an earlier due date is pointed out. Minutes are read the same way. An action item due before the meeting it was set in is overdue when it is written down. The dates in the due column, or after "due" in a list item, of an action-items section are compared with the date on the "Date" line near the top.
+
+message:
+  ja: 期限 {due} が、発行日 {issued} より前です
+  en: "The due date {due} is before the issue date {issued}"
+
+messages:
+  meeting:
+    ja: 宿題の期限 {due} が、会議の日 {meeting} より前です
+    en: "The action item's due date {due} is before the meeting date {meeting}"
+
+how_to_fix:
+  ja: 発行日と期限のどちらが正しいかを確かめて、片方を直してください。
+  en: Check which is right, the issue date or the due date, and correct the other.
+
+levels: { normal: error, relaxed: warning }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  legal: "An invoice or a quote sets an issue date and a deadline; in other genres a past deadline is something reported on, not this document's own."
+  docs: "An invoice or a quote sets an issue date and a deadline; in other genres a past deadline is something reported on, not this document's own."
+  academic: "An invoice or a quote sets an issue date and a deadline; in other genres a past deadline is something reported on, not this document's own."
+  literature: "An invoice or a quote sets an issue date and a deadline; in other genres a past deadline is something reported on, not this document's own."
+  speech: "An invoice or a quote sets an issue date and a deadline; in other genres a past deadline is something reported on, not this document's own."
+
+group: facts
+summary:
+  ja: 請求書や見積書で、支払期限や有効期限が発行日より前の所。議事録で、宿題の期限が会議の日より前の所
+  en: A payment due date or an expiry before the issue date of an invoice or a quote, or an action item in minutes due before the meeting
+example:
+  ja:
+    before: |
+      発行日：2026年11月30日
+
+      お支払期限：2026年11月25日
+    after: |
+      発行日：2026年11月30日
+
+      お支払期限：2026年12月25日
+  en:
+    before: |
+      Issued: November 30, 2026
+
+      Payment due: November 25, 2026
+    after: |
+      Issued: November 30, 2026
+
+      Payment due: December 25, 2026
+
+not_flagged:
+  ja: 行の頭に発行日や期限の語が無い日付（文の中の「12月25日までにお支払いください」）、年の無い日付、一行に日付が二つある行は比べません。発行日が二つあれば、最初のものと比べます。発行日から8行以上離れた期限と、期限が過ぎたことを書いた行（「期限切れ」「延滞」）は、この文書の期限ではなく報告している期限と読んで比べません。議事録として読むのは題に「議事録」などのある文書だけです。議事録では、宿題の節（見出しに「宿題」など）の外の日付、済んだ印のある宿題（升だけの「済」、括弧の中や行末の「完了」、チェック済みの箱）、前回の宿題を振り返る節、年の無い日付で年を越す期限（12月の会議の「1月10日」）は比べません。法令・規約、手引き、論文、文学、スピーチのジャンルでは止めています。
+  en: A date without a word at the head of its line (a due date in a sentence), a date without its year, and a line with two dates are not compared. With two issue dates, the first is used. A due date eight lines or more from the issue date, and a line that says the deadline has passed (overdue, expired), are read as reporting on a deadline rather than setting this document's own, and are not compared. Only a document whose title names it as minutes (Minutes, Meeting notes) is read as minutes. In minutes, a date outside an action-items section (a heading with Action items or the like), an item marked done (a Done cell, done in brackets or at the end of the line, a checked box), a section reviewing the previous meeting's items, and a deadline without a year that falls early in the next year (Jan 10 at a December meeting) are not compared. It is off in the legal, docs, academic, literature and speech genres.

package/rules/duplicate-definition.yaml

@@ -82,5 +82,5 @@ example:
       Users may use the Service free of charge.
 
 not_flagged:
-  ja: 二つの定義が食い違っているかは決めません。二つ目を指すだけです。語を名前にした見出しは定義に数えません。
-  en: Whether the two definitions conflict is not decided; only the second is pointed at. A heading that names the term is not a definition.
+  ja: 二つの定義が食い違っているかは決めません。二つ目を指すだけです。語を名前にした見出しは定義に数えません。英語で、括弧に引用符だけで入れた語句のうち、名前らしく大文字で始めていない語を含むもの（("The key point is")）は、例を引いたものとして定義に数えません。
+  en: 'Whether the two definitions conflict is not decided; only the second is pointed at. A heading that names the term is not a definition. In English, a phrase quoted alone in brackets with a word a name would capitalise left in lower case ("The key point is") quotes an example, and is not a definition.'