chaffjs 0.28.0 → 0.30.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/connection-time-short.yaml

@@ -0,0 +1,52 @@
+id: connection-time-short
+layer: L3
+status: stable
+how_to_find: connection-time-short
+requires: [dates]
+severity: warning
+
+name:
+  ja: 移動の時間より短い乗り継ぎ
+  en: A connection shorter than the stated travel time
+
+why:
+  ja: 「福岡 09:50着」のあと「09:55 博多駅で合流（福岡空港から地下鉄で約10分）」のように、文書に書いた移動の時間より次の予定までの間が短いと、どちらかの時刻か移動の時間を書き間違えています。そのまま動くと次の予定に遅れます。移動の時間は、文書に書いたもの（移動の語と同じ文の「約10分」「乗り換えに30分」）だけを使い、実際にかかる時間は推し量りません。移動を書いた予定（「10:00 京都駅から貸切バスで清水寺へ（約30分）」）はその時刻から次の予定まで、予定に添えた移動の時間はすぐ前の着の時刻からその予定までの間と比べます。
+  en: 'When a schedule leaves less time than the travel time it states itself, as in "arrives Washington Reagan 9:05 AM" followed by "9:15 AM Meet Ms. Tanaka at Metro Center (25 minutes from the airport by Metro)", one of the times or the travel time is wrong, and whoever follows it will be late. Only travel times the document states are used (a length in the same sentence as a word of travel: "about 40 minutes by train", "allow 45 minutes"); real travel times are never assumed. A line that is itself a move ("09:30 Coach from York station to the Minster (about 15 minutes)") is measured from its time to the next item of the day; a travel time added to an item is measured from the arrival just before it.'
+
+message:
+  ja: 「{from}」から「{time}」まで{gap}分しかなく、書いてある移動の時間（{travel}）より短いです
+  en: "Only {gap} minutes from {from} to {time}, less than the stated travel time ({travel})"
+
+how_to_fix:
+  ja: 着の時刻、次の予定の時刻、移動の時間を確かめて、書き間違えたものを直してください。
+  en: Check the arrival, the next time and the stated travel time, and correct the wrong one.
+
+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: An itinerary that leaves less time for a connection than the travel time it states
+example:
+  ja:
+    before: |
+      - 08:00 JAL 305便（羽田 08:00発、福岡 09:50着）
+      - 09:55 博多駅で合流（福岡空港から地下鉄で約10分）
+    after: |
+      - 08:00 JAL 305便（羽田 08:00発、福岡 09:50着）
+      - 10:30 博多駅で合流（福岡空港から地下鉄で約10分）
+  en:
+    before: |
+      - 7:30 AM Flight AA 2140 (departs Boston 7:30 AM, arrives Washington Reagan 9:05 AM)
+      - 9:15 AM Meet Ms. Tanaka at Metro Center (25 minutes from the airport by Metro)
+    after: |
+      - 7:30 AM Flight AA 2140 (departs Boston 7:30 AM, arrives Washington Reagan 9:05 AM)
+      - 10:00 AM Meet Ms. Tanaka at Metro Center (25 minutes from the airport by Metro)
+
+not_flagged:
+  ja: 移動の時間を書いていない所、上限として書いた時間（徒歩10分以内）、すぐ前の時刻が着でない所、日付の違う時刻、翌日の印のある時刻、時刻が戻る所（夜をまたぐ）、時間帯の印の違う時刻は言いません。
+  en: 'No stated travel time, a time given as an upper limit ("within 10 minutes"), a time whose previous time is not an arrival, times on different dates, a time marked as the next day, a time that goes back (overnight), and times with different time zones 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. When the period the document''s work is done in ("Term") is stated at the top or in the overview section, a date with a year after its end in an item or sentence of any later section that says "submit", "due" or "deadline" is reported (an assignment due after the term).'
+
+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. A deadline after a trip or a conference (an expense report) and a payment deadline are not reported.'

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."