chaffjs 0.28.0 → 0.29.0

package/rules/parameter-table-mismatch.yaml

@@ -0,0 +1,90 @@
+id: parameter-table-mismatch
+layer: L1
+status: stable
+how_to_find: parameter-table
+# The header words of a parameter table (Parameter, 引数) come from the parameter-header lexicon.
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 引数の表とシグネチャが合わない
+  en: Parameter table that does not match the signature
+
+why:
+  ja: API リファレンスで、関数のシグネチャと、その下の引数の表が違う引数を並べていると、読み手はどちらが正しいか分からず、無い引数を渡したり、必要な引数を知らずに終わったりします。引数を足したり名前を変えたりしたときに、片方だけを直すと起きます。コードブロックがちょうど一つの関数を宣言し（function や def、または戻り値の型が付いたもの）、次の見出しかコードブロックより前に、最初の列の見出しが「引数」や「Parameter」の表があるとき、両者を比べます。表にだけある引数は表の行を、シグネチャにだけある引数はシグネチャを指します。
+  en: When an API reference's signature and the parameter table under it list different parameters, the reader cannot tell which is right, and passes a parameter that does not exist or never learns of one that does. It happens when a parameter is added or renamed in one place only. When a code block declares exactly one function (with function or def, or with a return type) and a table whose first header is Parameter or Argument follows it before the next heading or code block, the two are compared. A parameter only in the table is pointed out on its row, and one only in the signature on the signature.
+
+message:
+  ja: 「{function}」の引数の表とシグネチャで、「{name}」が片方にしかありません
+  en: "`{name}` is in only one of the signature of `{function}` and its parameter table"
+
+how_to_fix:
+  ja: 実際の関数の引数を確かめて、表かシグネチャのどちらかを直してください。
+  en: Check the function's real parameters, and correct the table or the signature.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [technical, docs, blog, legal, academic, literature, speech]
+off_for:
+  legal: "Signatures and parameter tables belong to technical writing."
+  academic: "Signatures and parameter tables belong to technical writing."
+  literature: "Signatures and parameter tables belong to technical writing."
+  speech: "Signatures and parameter tables belong to technical writing."
+
+group: facts
+summary:
+  ja: API リファレンスで、引数の表とシグネチャの引数が食い違う所
+  en: A parameter in only one of a signature and the parameter table under it
+example:
+  ja:
+    config: { genre: technical/readme }
+    before: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      | 引数 | 型 | 説明 |
+      | --- | --- | --- |
+      | `text` | string | 幅を測る行 |
+      | `tabWidth` | number | タブ1つの幅 |
+    after: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      | 引数 | 型 | 説明 |
+      | --- | --- | --- |
+      | `text` | string | 幅を測る行 |
+      | `tabSize` | number | タブ1つの幅 |
+  en:
+    config: { genre: technical/readme }
+    before: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      | Parameter | Type | Description |
+      | --- | --- | --- |
+      | `text` | string | The line to measure |
+      | `tabWidth` | number | The width of one tab |
+    after: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      | Parameter | Type | Description |
+      | --- | --- | --- |
+      | `text` | string | The line to measure |
+      | `tabSize` | number | The width of one tab |
+
+not_flagged:
+  ja: 関数の呼び出し（wrap(text, 10);）、二つ以上の関数を宣言したコードブロック、分割代入の引数（{ a, b }）、self や this、最初の列の見出しが引数でない表（オプション、項目）、見出しやほかのコードブロックを挟んだ表、行の頭に | の無い表は比べません。型を名前の前に書く宣言（Java の String wrap(String text)）は読みません。表の「options.prefix」は options の項目として読みます。
+  en: "A call (wrap(text, 10);), a code block that declares two or more functions, a destructured parameter ({ a, b }), self and this, a table whose first header is not a parameter word (Option, Field), a table after another heading or code block, and a table whose rows do not start with | are not compared. A declaration with its types before the names (Java's String wrap(String text)) is not read. options.prefix in a table is read as a field of options."

package/rules/percent-sum-mismatch.yaml

@@ -10,8 +10,8 @@ name:
   en: Shares of a whole that do not add up to 100%
 
 why:
-  ja: 構成比や内訳の百分率を足して 100% にならないと、読み手はどの数字が違うのか、項目が抜けたのかを確かめることになります。項目を足したり消したり、数字を一つだけ直したりしたときに起きます。表のその列の見出しか、箇条書きや表のすぐ上の文・見出しに、全体を分けた割合の語（構成比、内訳、シェア）があるときだけ足します。一つの文に並べた内訳（「構成比は、Aが50%、Bが30%、Cが25%」）も、その文に割合の語があり百分率が三つ以上あれば足します。丸めの誤差は、項目ごとに最後の桁の半分まで（少なくとも 1 ポイント）認めます。
-  en: When the shares of a whole do not add up to 100%, the reader has to work out which figure is wrong or which item is missing. It happens when an item is added or removed, or when one figure is changed. The percentages are added only when the column's header, or the sentence or heading right above the list or the table, names the parts of a whole (breakdown, market share, composition). A breakdown written in one sentence ("software made up 50% of sales, maintenance 30% and training 25%") is added too, when the sentence has such a word and three or more percentages. Rounding is allowed, up to half the last digit per item (at least one point).
+  ja: 構成比や内訳の百分率を足して 100% にならないと、読み手はどの数字が違うのか、項目が抜けたのかを確かめることになります。項目を足したり消したり、数字を一つだけ直したりしたときに起きます。表のその列の見出しか、箇条書きや表のすぐ上の文・見出しに、全体を分けた割合の語（構成比、内訳、シェア）があるときだけ足します。表の列の見出しが「割合」「配点」「比率」「ウェイト」だけ（単位の括弧は除く）の列も、全体を分けた割合として足します。ただし表のすぐ上の文や見出し、または表の行が率（前年比、達成率、金利）を名指していれば足しません。一つの文に並べた内訳（「構成比は、Aが50%、Bが30%、Cが25%」）も、その文に割合の語があり百分率が三つ以上あれば足します。割合の語が無くても、最後の百分率が全体の残り（「その他が 5%」）なら、その文は一つの全体を分けたものとして足します。ただし、百分率のすぐ前後に値の動いた向きの語（伸びた、増加）がある文は変化を並べたものなので足しません。丸めの誤差は、項目ごとに最後の桁の半分まで（少なくとも 1 ポイント）認めます。
+  en: When the shares of a whole do not add up to 100%, the reader has to work out which figure is wrong or which item is missing. It happens when an item is added or removed, or when one figure is changed. The percentages are added only when the column's header, or the sentence or heading right above the list or the table, names the parts of a whole (breakdown, market share, composition). A column whose header is only "Weight", "Share", "Percentage" or "Proportion" (a unit in brackets aside) is added too, unless the sentence or heading right above the table, or one of its rows, names a rate (growth, interest rate, year over year). A breakdown written in one sentence ("software made up 50% of sales, maintenance 30% and training 25%") is added too, when the sentence has such a word and three or more percentages, or when its last percentage is the rest of the whole ("other 5%"), which only the parts of one whole have, unless a word for which way values moved stands right next to a percentage (grew 45%). Rounding is allowed, up to half the last digit per item (at least one point).
 
 message:
   ja: 内訳の割合の和が {sum} で、100% になりません

package/rules/phone-number-variant.yaml

@@ -0,0 +1,68 @@
+id: phone-number-variant
+layer: L3
+status: stable
+how_to_find: phone-number-variant
+word_list: phone-label
+# The labels (電話, Phone, FAX) and what each labels come from the language's phone-label lexicon; numbers after labels of
+# different kinds (a phone and a fax number) are never compared.
+languages: [ja, en]
+severity: warning
+
+name:
+  ja: 電話番号の数字の入れ違い
+  en: Phone number with two digits swapped
+
+why:
+  ja: 問合せ先の電話番号は、本文の上と下、申込先と問合せ先のように何度も書かれます。一か所だけ「0120-123-456」が「0120-123-465」になっていると、読み手はどちらが正しいか分からず、間違った方にかけることもあります。隣り合う二つの数字の入れ違いは、打ち間違いで最も多い形です。「電話」「TEL」のような同じ種類の語の後ろに書いた番号どうしを比べ、隣り合う二つの数字だけが入れ違った番号を指します。
+  en: 'A contact number is written more than once: at the top and the bottom, under "How to apply" and under "Contact". When one place reads 0120-123-465 for 0120-123-456, the reader cannot tell which is right and may call the wrong one. Two neighbouring digits swapped is the commonest slip in typing a number. chaff compares the numbers written after labels of the same kind (Phone, Tel, call) and reports one that is another with two neighbouring digits swapped.'
+
+message:
+  ja: 電話番号「{written}」は、「{other}」の隣り合う数字が入れ違っています
+  en: "The phone number {written} is {other} with two neighbouring digits swapped"
+
+how_to_fix:
+  ja: 正しい番号を確かめて、もう一方を直してください。
+  en: Check which number is right and correct the other.
+
+levels: { strict: error, normal: warning, relaxed: warning }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  literature: A story's phone numbers are made up and need not agree; one may differ on purpose.
+  speech: A transcript writes what was said, numbers misspoken and corrected included.
+
+group: facts
+summary:
+  ja: 同じ文書で、電話番号の隣り合う数字が一か所だけ入れ違っている所（0120-123-456 と 0120-123-465）
+  en: One phone number written elsewhere with two neighbouring digits swapped (0120-123-456 and 0120-123-465)
+example:
+  ja:
+    before: |
+      # お知らせ
+
+      申込先　電話：0120-123-456
+
+      問合せ先　電話：0120-123-465
+    after: |
+      # お知らせ
+
+      申込先　電話：0120-123-456
+
+      問合せ先　電話：0120-123-456
+  en:
+    before: |
+      # Notice
+
+      To apply, phone: 0120-123-456
+
+      Contact, phone: 0120-123-465
+    after: |
+      # Notice
+
+      To apply, phone: 0120-123-456
+
+      Contact, phone: 0120-123-456
+
+not_flagged:
+  ja: 番号と同じ行で、前に「電話」「TEL」「お問合せ」のような語がある番号だけを読みます。語の無い数字の並び、種類の違う番号（電話とFAX）、数字が一つだけ違う番号（代表と直通、本店と支店の番号はよくそうなります）、離れた数字の入れ違いは指しません。数字が9桁から13桁で、ハイフンか括弧で区切ったものだけを番号と見ます。
+  en: "Only numbers with a label (phone, tel, call) before them on their line are read. Unlabelled runs of digits, numbers of different kinds (a phone and a fax number), numbers that differ in one digit (a main line and a direct line often do) and swaps of digits that are not neighbours are not reported. A number is 9 to 13 digits, grouped by hyphens or brackets."

package/rules/prerequisite-after-step.yaml

@@ -0,0 +1,78 @@
+id: prerequisite-after-step
+layer: L3
+status: stable
+how_to_find: prerequisite-order
+# The openers come from the language's prerequisite-opener lexicon; a procedure is a numbered list of three or more items.
+languages: [ja, en]
+severity: info
+
+name:
+  ja: 手順の後に書いた前提
+  en: Prerequisite written after the steps
+
+why:
+  ja: 「作業を始める前に、注文サービスを止めておきます。」が番号付きの手順の後にあると、読み手はそれを読む時には手順を終えています。前提・必要な権限・準備は、手順の前に書くものです。文を足したり節を並べ替えたりしたときに起きます。節の中で、番号付きの手順（三つ以上）より後に「作業を始める前に」「始める前に」で始まる文があるとき指します。
+  en: 'When "Before you begin, stop the order service." comes after the numbered steps, the reader has done the steps by the time they read it. Prerequisites, permissions and preparation go before the steps. It happens when a sentence is added at the end or sections are reordered. A sentence opening with "Before you begin" or "Before you start" after a numbered procedure (three steps or more) in the same section is reported.'
+
+message:
+  ja: 手順の前にするべきことを、手順の後に書いています
+  en: This prerequisite comes after the steps it applies to
+
+how_to_fix:
+  ja: この文を、手順の前（「始める前に」の節か、手順のすぐ上）に移してください。
+  en: Move the sentence before the steps, into a "Before you begin" section or right above the list.
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [technical, docs, blog, legal, academic, literature, speech]
+off_for:
+  legal: "Code blocks, shell prompts, command headings and numbered steps belong to technical writing."
+  academic: "Code blocks, shell prompts, command headings and numbered steps belong to technical writing."
+  literature: "Code blocks, shell prompts, command headings and numbered steps belong to technical writing."
+  speech: "Code blocks, shell prompts, command headings and numbered steps belong to technical writing."
+
+group: structure
+summary:
+  ja: 節の番号付きの手順より後にある、「作業を始める前に」「始める前に」で始まる文
+  en: A sentence opening with "Before you begin" after the numbered steps of its section
+example:
+  ja:
+    config: { genre: docs/manual }
+    before: |
+      # 復元する
+
+      1. コンソールを開きます。
+      2. バックアップを選びます。
+      3. ［復元を開始］を押します。
+
+      作業を始める前に、注文サービスを止めておきます。
+    after: |
+      # 復元する
+
+      作業を始める前に、注文サービスを止めておきます。
+
+      1. コンソールを開きます。
+      2. バックアップを選びます。
+      3. ［復元を開始］を押します。
+  en:
+    config: { genre: docs/manual }
+    before: |
+      # Restore
+
+      1. Open the console.
+      2. Select the backup.
+      3. Click **Start Restore**.
+
+      Before you begin, stop the order service.
+    after: |
+      # Restore
+
+      Before you begin, stop the order service.
+
+      1. Open the console.
+      2. Select the backup.
+      3. Click **Start Restore**.
+
+not_flagged:
+  ja: 番号付きの手順が三つ以上ある節の、その手順より後の文だけを読みます。手順の前にある前提、後の節の手順のための前提（その節の手順より前にあるもの）、「手順 4 の前に」のように一つの手順を名指す文、読点の続かない「始める前に戻すには」、引用やコードの中の手順は指しません。技術文書・手順書・ブログでだけ動きます。
+  en: 'Only sentences after a numbered procedure of three or more steps in the same section are read. A prerequisite before its steps, one for a later section''s steps (written before those steps), a sentence naming one step ("Before step 4, split the file" or "Before you begin step 3"), and a procedure in a block quote or a code block are not reported. Technical documents, manuals and blogs only.'

package/rules/quote-unnamed-speaker.yaml

@@ -0,0 +1,67 @@
+id: quote-unnamed-speaker
+layer: L2
+status: stable
+how_to_find: quote-unnamed-speaker
+word_list: unnamed-speaker
+# The roles (アナリスト, an analyst), the words that may follow a role at the head of the speaker's phrase, titles and the
+# words pointing back come from the language's unnamed-speaker word list; the words that give a quotation to someone from
+# quote-attribution.
+extra_word_lists: [quote-attribution]
+languages: [ja, en]
+severity: info
+
+name:
+  ja: 名前の無い話し手の言葉を引いている
+  en: A quotation given to a speaker with no name
+
+why:
+  ja: プレスリリースや報告書は、引いた言葉で主張を支えます。「業界のアナリストは『…』と述べています」の話し手が誰なのかが書かれていないと、読み手はその人に確かめることも、その人の立場を量ることもできません。書き手が自分の言いたいことを名前の無い誰かに言わせている、と読まれることもあります。chaff はその人が本当に言ったかを知りませんが、確かめる相手が書かれていないことは言えます。鉤括弧や引用符で引いた言葉のすぐ前かすぐ後ろに話し手が書かれていて、その話し手が「アナリスト」「関係者」のような役の語だけで、名前が無いときに指します（役の語の一覧は言語ごとの語彙表 unnamed-speaker にあります）。
+  en: 'Press releases and reports back their claims with quotations. When the speaker of "Few products do this," said an analyst is not named, the reader can neither check with that person nor weigh where they stand, and may read it as the writer''s own claim put in an unnamed mouth. chaff cannot know who said what, but it can say that nobody to check with is named. It points at a quotation in quotation marks whose speaker, right before or right after it, is only a role ("an analyst", "a source", "officials"; the roles are in each language''s unnamed-speaker word list) with no name.'
+
+message:
+  ja: 「{quote}」の話し手が「{speaker}」とだけ書かれていて、名前がありません
+  en: '"{quote}" is given to "{speaker}", who is not named'
+
+how_to_fix:
+  ja: 話し手の名前と所属を書いてください（「ミナトリサーチのアナリスト、森花子氏は」）。名前を出せない相手なら、その言葉に頼らない書き方にするか、調査報告のような題名のある文書を出典にしてください。
+  en: 'Name the speaker and where they work ("said Hanako Mori, an analyst at Minato Research"). If the person cannot be named, do not lean on the quotation: say it without it, or cite a document named by its title.'
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [business/press-release, business/report, legal, docs, academic, literature, speech]
+off_for:
+  legal: "A quotation given to an unnamed role: only press releases and reports turn this on; quote-without-source reads quotations elsewhere."
+  docs: "A quotation given to an unnamed role: only press releases and reports turn this on; quote-without-source reads quotations elsewhere."
+  academic: "A quotation given to an unnamed role: only press releases and reports turn this on; quote-without-source reads quotations elsewhere."
+  literature: "A quotation given to an unnamed role: only press releases and reports turn this on; quote-without-source reads quotations elsewhere."
+  speech: "A quotation given to an unnamed role: only press releases and reports turn this on; quote-without-source reads quotations elsewhere."
+
+group: facts
+summary:
+  ja: 「業界のアナリストは『…』と述べています」のように、名前の無い話し手の言葉を引いた所
+  en: A quotation given to a speaker named only by a role ("…," said an analyst)
+example:
+  ja:
+    config: { genre: business/press-release }
+    before: |
+      # 新版の提供について
+
+      業界のアナリストは「在庫を一画面で見られる製品は、中小企業ではまだ少ない」と述べています。
+    after: |
+      # 新版の提供について
+
+      ミナトリサーチのアナリストの森花子氏は「在庫を一画面で見られる製品は、中小企業ではまだ少ない」と述べています。
+  en:
+    config: { genre: business/press-release }
+    before: |
+      # The new version
+
+      "Few products for small businesses show all their stock on one screen," said an analyst.
+    after: |
+      # The new version
+
+      "Few products for small businesses show all their stock on one screen," said Hanako Mori, an analyst at Minato Research.
+
+not_flagged:
+  ja: 話し手に名前があれば見ません。役の語の後ろに名前が続くもの（アナリストの森花子氏）、話し手の句に「氏」「さん」「様」「教授」のような名前に付く語があるものは、名前を出したと見ます。一人に決まる役（代表取締役社長、当社CEO）は役の語の一覧に無いので見ません。「同アナリスト」「このアナリスト」のように前に名前を出した人を指し直すもの、題名を示した文書（『2026年版在庫白書』によれば）、役の語が話し手でないもの（専門家会議の報告書）も見ません。10字に満たない短い引用は語や名前を引いたものと見て読みません。プレスリリースと報告書だけで見ます。ほかの文書で人の言葉に出典が無いことは quote-without-source が見ます。
+  en: 'A speaker with a name is not reported: a name after the role ("analyst Hanako Mori"), a name before it ("Hanako Mori, an analyst"), or a title (Ms, Dr). A role that is one person (the CEO of Acme) is not in the word list. A role that points back at someone named before ("the analyst", "our spokesperson"), a document named by its title, and a role that is not the speaker ("an official statement") are not reported. A quotation shorter than ten characters names a word or a thing and is not read. Only press releases and reports are read; elsewhere, quote-without-source looks for a quotation with no source.'

package/rules/quote-without-source.yaml

@@ -9,16 +9,16 @@ name:
   en: A quotation given to someone, with no source
 
 why:
-  ja: 「〜は『…』と述べている」のように人の言葉として引いた文は、読み手がその人の言葉だと信じて読みます。出典が無いと、本当にその人がそう言ったのか、言い回しが正しいのかを誰も確かめられません。人から人へ伝わるうちに言葉が変わったり、言った人が入れ替わったりするのは、引用でいちばんよく起きる誤りです。chaff はその人が本当に言ったかを知りませんが、確かめる手がかりが無いことは言えます。鉤括弧や引用符で引いた文の直後か少し前に、誰かに帰する言い回し（「と述べ」「によれば」。語の一覧は言語ごとの語彙表にあります）があり、同じ段落にリンクも脚注も番号の引用も括弧の中の年も無いときに指します。
-  en: 'A quotation given to someone ("X once said …", "according to X") is read as that person''s words. With no source, nobody can check that the person said it, or said it that way; words change and speakers swap as a quotation is passed along, which is the commonest error in quoting. chaff cannot know who said what, but it can say there is nothing to check the quotation against. It points at a quotation in quotation marks given to someone by the words right after it or shortly before it ("said", "according to"; the words are in each language''s word list), in a paragraph with no link, no footnote, no numbered citation and no year in brackets.'
+  ja: 「〜は『…』と述べている」のように人の言葉として引いた文は、読み手がその人の言葉だと信じて読みます。出典が無いと、本当にその人がそう言ったのか、言い回しが正しいのかを誰も確かめられません。人から人へ伝わるうちに言葉が変わったり、言った人が入れ替わったりするのは、引用でいちばんよく起きる誤りです。chaff はその人が本当に言ったかを知りませんが、確かめる手がかりが無いことは言えます。鉤括弧や引用符で引いた文の直後か少し前に、誰かに帰する言い回し（「と述べ」「によれば」。語の一覧は言語ごとの語彙表にあります）があり、同じ段落にリンクも脚注も番号の引用も括弧の中の年も無いときに指します。Markdown の引用（`>`）の終わりかすぐ次の行に「— 名前」と書いた引用も、名前の行と引用の中に出典が無ければ指します。
+  en: 'A quotation given to someone ("X once said …", "according to X") is read as that person''s words. With no source, nobody can check that the person said it, or said it that way; words change and speakers swap as a quotation is passed along, which is the commonest error in quoting. chaff cannot know who said what, but it can say there is nothing to check the quotation against. It points at a quotation in quotation marks given to someone by the words right after it or shortly before it ("said", "according to"; the words are in each language''s word list), in a paragraph with no link, no footnote, no numbered citation and no year in brackets. A Markdown block quotation (`>`) with a dash line ("— Name") as its last line or right after it is given to someone too, and is pointed at when neither the quotation nor that line gives a source.'
 
 message:
   ja: 「{quote}」を人の言葉として引いていますが、出典（リンク、脚注、書誌）がありません
   en: '"{quote}" is given to someone, but no source (a link, a footnote, a reference) is given'
 
 how_to_fix:
-  ja: 同じ段落に出典を書いてください。Web で読めるならリンクを、本や論文なら「（著者, 書名, 年）」か脚注を付けます。出典が見つからないなら、言い回しを確かめられるまで人の言葉としては引かないでください。出典を書いたら、`chaff cite <出典> <引用.json>` で、その言葉が出典に本当にあるかを照らせます（chaff --format json の quote がそのまま使えます）。
-  en: 'Name the source in the same paragraph: a link when it can be read online, or "(Author, Title, year)" or a footnote for a book or a paper. If no source can be found, do not give the words to the person until they can be checked. With the source in hand, `chaff cite <source> <quotes.json>` checks that the words are really there (each finding''s quote in chaff --format json is the text to check).'
+  ja: 同じ段落に出典を書いてください。Web で読めるならリンクを、本や論文なら「（著者, 書名, 年）」か脚注を付けます。出典が見つからないなら、言い回しを確かめられるまで人の言葉としては引かないでください。`chaff cite --scaffold <文書>` がこうした引用を引用.json のひな形にするので、source に出典のファイルを書いて `chaff cite <引用.json>` を動かせば、その言葉が出典に本当にあるかを照らせます。
+  en: 'Name the source in the same paragraph: a link when it can be read online, or "(Author, Title, year)" or a footnote for a book or a paper. If no source can be found, do not give the words to the person until they can be checked. `chaff cite --scaffold <document>` writes these quotations as a quotes.json to fill in: put the source''s file in each `source`, and `chaff cite <quotes.json>` checks that the words are really there.'
 
 levels: { strict: warning, normal: info, relaxed: info }
 
@@ -57,5 +57,5 @@ example:
       As one engineer put it, "adding people to a late project only makes it later" ([source](https://example.com/essay)). Before adding people, ask whether the work can be split.
 
 not_flagged:
-  ja: 短い鉤括弧（「保存」ボタン、「出典」という語）は語や名前を引いたもので、人の言葉ではないので見ません。誰かに帰する言い回しが引用のすぐ後ろ（「…」と述べた）か少し前（によれば「…」）に無い引用は、書き手自身の言葉か、題名や言い換えなので見ません。同じ段落にリンク、URL、脚注（[^1]）、番号の引用（[3]）、括弧の中の年（（1975）、（1999年））があれば、出典を書いたと見ます。出典が正しいかは見ません。それは `chaff cite` が照らします。記事（ブログ、エッセイ）と論文で見ます。組織の記事は取材した人の言葉を、プレスリリースや報告書は自分たちの言葉や題名で示した文書を引くので、手順書、仕様、契約や法令、小説、話し言葉とあわせて既定で止めています。
-  en: 'A short quotation (the "Save" button, the word "source") names a word or a thing, not someone''s words, and is not read. A quotation with no such words right after it or shortly before it is the writer''s own words, a title or a paraphrase. A link, a URL, a footnote ([^1]), a numbered citation ([3]) or a year in brackets ((1975)) in the same paragraph counts as a source. Whether the source is right is not checked here: `chaff cite` checks that. Blog posts, essays and papers are read. An organisation''s articles quote the people they interviewed, and press releases and reports quote their own people or documents named by title, so they are left out by default, with manuals, specifications, contracts and statutes, fiction and speech.'
+  ja: 短い鉤括弧（「保存」ボタン、「出典」という語）は語や名前を引いたもので、人の言葉ではないので見ません。誰かに帰する言い回しが引用のすぐ後ろ（「…」と述べた）か少し前（によれば「…」）に無い引用は、書き手自身の言葉か、題名や言い換えなので見ません。「…」と述べる方が適切です、「…」と書くべきです、のように言い方を勧める続きは、人の言葉を引いていないので見ません（続きの一覧は語彙表 quote-advice にあります）。引用の前に誰かに帰する言い回しがあれば（山田氏によれば「…」と言う方が適切だ）、勧めでも人の言葉として見ます。同じ段落にリンク、URL、脚注（[^1]）、番号の引用（[3]）、括弧の中の年（（1975）、（1999年））があれば、出典を書いたと見ます。「— 名前」の行が無い `>` の引用は、誰の言葉かを示していないので見ません。「— 名前、書名（1975）」のように名前の行に年やリンクがあれば、出典を書いたと見ます。出典が正しいかは見ません。それは `chaff cite` が照らします。記事（ブログ、エッセイ）と論文で見ます。組織の記事は取材した人の言葉を、プレスリリースや報告書は自分たちの言葉や題名で示した文書を引くので、手順書、仕様、契約や法令、小説、話し言葉とあわせて既定で止めています。
+  en: 'A short quotation (the "Save" button, the word "source") names a word or a thing, not someone''s words, and is not read. A quotation with no such words right after it or shortly before it is the writer''s own words, a title or a paraphrase. In Japanese, words right after the quotation that suggest a wording rather than quote it (「…」と述べる方が適切です) are not read either, unless a word before the quotation gives it to someone; the word list quote-advice holds them. English has no such list yet. A link, a URL, a footnote ([^1]), a numbered citation ([3]) or a year in brackets ((1975)) in the same paragraph counts as a source. A `>` block quotation with no dash line ("— Name") does not say whose words it holds and is not read; a dash line with a year or a link ("— Name, Title (1975)") counts as a source. Whether the source is right is not checked here: `chaff cite` checks that. Blog posts, essays and papers are read. An organisation''s articles quote the people they interviewed, and press releases and reports quote their own people or documents named by title, so they are left out by default, with manuals, specifications, contracts and statutes, fiction and speech.'

package/rules/requirement-smell.yaml

@@ -4,7 +4,7 @@ status: stable
 how_to_find: requirement-smell
 # 要求の文の目印と、三つの見つけ方の語。語はすべて言語ごとの語彙表にある。
 word_list: requirement-marker
-extra_word_lists: [requirement-loophole, requirement-open-end, requirement-either]
+extra_word_lists: [requirement-loophole, requirement-open-end, requirement-either, definition-statement]
 uses: [pos]
 severity: info
 
@@ -74,5 +74,5 @@ example:
     config: { genre: technical/spec }
 
 not_flagged:
-  ja: 要求の文でない文（説明や背景）、法令、ブログやビジネス文書は見ません。語彙表にない言い方は指しません。
-  en: Sentences that state no requirement (background, explanation), statutes, and blogs and business documents are not checked. Phrases not on chaff's lists are not reported.
+  ja: 要求の文でない文（説明や背景）、法令、ブログやビジネス文書は見ません。語彙表にない言い方は指しません。文書が定めた名前の「等」（以下「委託先等」という、銀行等（…をいう。）、定義の号の頭の語）と、監査等委員会のように後ろへ語が続く「等」は、列挙を閉じているので指しません。
+  en: Sentences that state no requirement (background, explanation), statutes, and blogs and business documents are not checked. Phrases not on chaff's lists are not reported. An open-ended word inside a name the document defines (a quoted term, or one defined in the brackets after it) is not reported.

package/rules/sentence-initial-conjunction-run.yaml

@@ -3,7 +3,8 @@ layer: L3
 status: stable
 how_to_find: conjunction-run
 word_list: sentence-opener
-languages: [en]
+languages: [ja, en]
+uses: [pos]
 severity: info
 
 name:
@@ -11,8 +12,8 @@ name:
   en: Run of sentences opening with a conjunction
 
 why:
-  ja: 接続詞で始まる文は 1 つなら効きますが、続くとどの文も前の文の付け足しに見えて、何が主張なのかが分からなくなります。
-  en: One sentence opening with "And" or "But" lands. A run of them makes every sentence read as an afterthought.
+  ja: 「そして」「しかし」「また」（英語の And、But）で始まる文は 1 つなら効きますが、続くとどの文も前の文の付け足しに見えて、何が主張なのかが分からなくなります。語の一覧は言語ごとの語彙表にあります。
+  en: One sentence opening with "And" or "But" (そして, しかし) lands. A run of them makes every sentence read as an afterthought. The words are listed in the lexicon.
 
 message:
   ja: 接続詞で始まる文が {count} 文続いています（{limit} 文まで）
@@ -32,9 +33,14 @@ off_for:
 
 group: readability
 summary:
-  ja: 英語で、And や But で始まる文が続く所
-  en: A run of sentences that open with "And", "But" or "So"
+  ja: 「そして」「しかし」（And、But）で始まる文が続く所
+  en: A run of sentences that open with "And", "But" or "So" (そして, しかし)
 example:
+  ja:
+    before: |
+      月曜に更新を出しました。しかし、ログイン画面が壊れました。そして、直すのに二日かかりました。また、その間は一部の人が入れませんでした。
+    after: |
+      月曜に出した更新で、ログイン画面が壊れました。直すのに二日かかり、その間は一部の人が入れませんでした。
   en:
     before: |
       We shipped the update on Monday. But the login page broke. And the fix took two days. So some customers could not sign in.
@@ -42,8 +48,8 @@ example:
       We shipped the update on Monday, and the login page broke. The fix took two days, during which some customers could not sign in.
 
 not_flagged:
-  ja: And や But で始まる文が一つだけなら指しません。
-  en: One sentence opening with "And" or "But" is not reported.
+  ja: 接続詞で始まる文が一つだけなら指しません。日本語では、話し言葉の文頭（でも、だから、なので）は colloquial-opener が、「さらに」「加えて」は stock-transition が見るので数えません。
+  en: One sentence opening with "And" or "But" is not reported. In Japanese, spoken openers (でも, だから, なので) are colloquial-opener's and さらに, 加えて are stock-transition's, so they are not counted.
 level_meaning:
   ja: 接続詞で始まる文の連続 {limit} 文まで
   en: up to {limit} sentences in a row opening with a conjunction

package/rules/summary-fact-mismatch.yaml

@@ -11,8 +11,8 @@ name:
   en: A summary value that differs from the body
 
 why:
-  ja: 冒頭や「概要」の節は、本文を読まない人も読みます。そこに書いた値が本文と違うと、要約だけを読んだ人が間違った値を持ち帰ります。本文を直したあとに、要約を直し忘れると起きます。最初の見出しより前の文と、概要・要約・まとめの節の「項目：値」「項目は値です」を、本文の同じ項目の値と比べます。英語の文書では、名前の無い数も、数える動詞と数えるもの（We gained 52 new customers）が同じ本文の数と比べます。本文の値が一通りに揃っていて、要約の値がそれと違うときだけ指します。
-  en: 'The opening and the summary are read by people who never read the body. A value there that differs from the body sends them away with the wrong one. It happens when the body is corrected and the summary is not. Values written as "Item: value" or "The item is value" before the first heading, or in a section headed Summary, Abstract or Overview, are compared with the body''s values for the same item, and so is a count with no label, by the verb and the words of what it counts ("We gained 52 new customers"); it is pointed out only when the body gives one value throughout and the summary gives another.'
+  ja: 冒頭や「概要」の節は、本文を読まない人も読みます。そこに書いた値が本文と違うと、要約だけを読んだ人が間違った値を持ち帰ります。本文を直したあとに、要約を直し忘れると起きます。最初の見出しより前の文と、概要・要約・まとめの節の「項目：値」「項目は値です」を、本文の同じ項目の値と比べます。英語の文書では、名前の無い数も、数える動詞と数えるもの（We gained 52 new customers）が同じ本文の数と比べます。要約の「誤りの率は 2.4% から 1.6% に」は、本文が同じ項目を二つの条件（導入前と導入後、無いときとあるとき、2025年と2026年）で書いた二つの値と組にして比べます。冒頭の「11月9日から提供します」のような出来事の日付は、本文で同じ出来事の語（提供、発売、開催）と日付を一つずつ持つ文の日付と比べます。本文の値が一通りに揃っていて、要約の値がそれと違うときだけ指します。
+  en: 'The opening and the summary are read by people who never read the body. A value there that differs from the body sends them away with the wrong one. It happens when the body is corrected and the summary is not. Values written as "Item: value" or "The item is value" before the first heading, or in a section headed Summary, Abstract or Overview, are compared with the body''s values for the same item, and so is a count with no label, by the verb and the words of what it counts ("We gained 52 new customers"). A summary''s "lowered the error rate from 2.4% to 1.6%" is paired with the two values the body gives the same item under two conditions (before and after, without and with, 2025 and 2026). The date of an event in the opening ("will release it on November 9, 2026") is compared with a body sentence that has a word for the same event (release, launch, held) and one date. It is pointed out only when the body gives one value throughout and the summary gives another.'
 
 message:
   ja: 冒頭・要約の「{label}」 {value} が、本文の {other} と違います
@@ -69,8 +69,8 @@ example:
       The fee is $350.
 
 not_flagged:
-  ja: 本文に同じ項目の値が二通り以上あるとき（回ごと、対象ごとの値）は、要約がどれと合うべきか決まらないので言いません。単位の違う値、条件の付いた値（「3,000円から」）も比べません。
-  en: When the body gives the item more than one value (per session, per group), which one the summary should match is not settled, so nothing is said. Values in different units and values with a condition ("from $300") are not compared.
+  ja: 本文に同じ項目の値が二通り以上あるとき（回ごと、対象ごとの値）は、要約がどれと合うべきか決まらないので言いません。単位の違う値、条件の付いた値（「3,000円から」）も比べません。「XからYに」は、本文の文に同じ項目の名前があり、二つの値のどちらの条件も読めたときだけ比べます。幅（ranging from 10 to 20）は変化ではないので比べません。出来事の日付は、年月日まで書いた日付どうしだけを比べます。日付が二つある文（期間）や、別の出来事の語も持つ文（発表した日と提供する日）、冒頭の文に無い名前（別の製品）を持つ本文の文は比べません。
+  en: When the body gives the item more than one value (per session, per group), which one the summary should match is not settled, so nothing is said. Values in different units and values with a condition ("from $300") are not compared. A "from X to Y" is compared only when a body sentence names the same item and the condition of each of its two values can be read; a range ("ranging from 10 to 20") is not a change and is left alone. An event's date is compared only when both dates give the year, month and day; a sentence with two dates (a period) or with the words of another event (the day it was announced and the day of the release) is not read, nor is a body sentence that names something the opening sentence does not (another product).
 rewrite:
   depth: light
   ja:

package/rules/tax-mismatch.yaml

@@ -0,0 +1,71 @@
+id: tax-mismatch
+layer: L3
+status: stable
+how_to_find: tax-amount
+# The words of a tax row and of an included tax come from the language's tax-label and tax-included-word lexicons; the
+# subtotal row is found with total-label, the lexicon total-mismatch reads.
+requires: [quantities]
+languages: [ja, en]
+severity: error
+
+name:
+  ja: 税額が小計に税率を掛けた額と合わない
+  en: A tax that is not its rate of the subtotal
+
+why:
+  ja: 見積書や請求書の「消費税（10%）」の金額が、小計の10%と合わないと、読み手は税の計算を確かめ直し、合計も信じられなくなります。合計の額に税率を掛けてしまったときや、小計を直して税を直し忘れたときに起きます。表か箇条書きで、税の語（消費税・税額）で始まり率を書いた行の金額を、上の小計の行の金額（小計の行が無ければ上の項目の和）に率を掛けた額と比べます。
+  en: When the "Sales tax (10%)" of a quote or an invoice is not 10% of the subtotal, the reader has to work the tax out again and can no longer trust the total. It happens when the rate is applied to the total instead of the subtotal, or when the subtotal is changed and the tax is not. In a list or a table, the amount of a line starting with a tax word (Tax, Sales tax, VAT) and giving a rate is compared with that rate of the subtotal line above it (or, with no subtotal line, of the sum of the items above).
+
+message:
+  ja: 税額「{written}」が、上の金額の{rate}（{expected}）と合いません
+  en: "The tax {written} is not {rate} of the amount above it ({expected})"
+
+how_to_fix:
+  ja: 小計と税率を確かめて、税額を計算し直してください。合計も一緒に直します。
+  en: Check the subtotal and the rate and work the tax out again. Correct the total with it.
+
+levels: { normal: error, relaxed: warning }
+
+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: 見積書や請求書で、「消費税（10%）」の金額が小計の10%と合わない所
+  en: A tax line in a quote or an invoice whose amount is not its rate of the subtotal
+example:
+  ja:
+    before: |
+      | 項目 | 金額 |
+      | --- | --- |
+      | 設計 | 300,000円 |
+      | 開発 | 500,000円 |
+      | 小計 | 800,000円 |
+      | 消費税（10%） | 88,000円 |
+    after: |
+      | 項目 | 金額 |
+      | --- | --- |
+      | 設計 | 300,000円 |
+      | 開発 | 500,000円 |
+      | 小計 | 800,000円 |
+      | 消費税（10%） | 80,000円 |
+  en:
+    before: |
+      | Item | Amount |
+      | --- | --- |
+      | Design | $3,000 |
+      | Build | $5,000 |
+      | Subtotal | $8,000 |
+      | Sales tax (10%) | $880 |
+    after: |
+      | Item | Amount |
+      | --- | --- |
+      | Design | $3,000 |
+      | Build | $5,000 |
+      | Subtotal | $8,000 |
+      | Sales tax (10%) | $800 |
+
+not_flagged:
+  ja: 端数は切り捨て・四捨五入・切り上げのどれでも合っていると読みます。率を書いていない税の行、合計に含まれる税（「うち消費税」「内税」）の行、率の違う税の行が並ぶ表（軽減税率の8%と10%）、小計と税の行の間に金額の行（値引き・送料）がある表は比べません。文の中に書いた税は読みません。
+  en: Rounding down, to the nearest or up are all read as right. A tax line with no rate, a line for tax included in the total ("tax included"), a table with tax lines of different rates, and a table with an amount line (a discount, shipping) between the subtotal and the tax are not compared. A tax written in a sentence is not read.

package/rules/time-order.yaml

@@ -0,0 +1,65 @@
+id: time-order
+layer: L3
+status: stable
+how_to_find: time-order
+requires: [dates]
+severity: warning
+
+name:
+  ja: 一日の予定の時刻が前後している
+  en: A time out of order in a day's schedule
+
+why:
+  ja: 旅程や式次第のように、頭に時刻を書いた項目を並べた箇条書きや表で、ひとつだけ前の項目より早い時刻があると、書き間違いか順番の入れ替わりかを読み手が確かめることになり、集まる時刻を間違える人も出ます。一日の予定は早い順に並ぶので、その順に逆らう時刻を指します。日付の見出しが変わるところ、行の頭の日付が変わるところで一日を区切ります。23:30 の次の 0:15 のように夜をまたぐ時刻は、翌日の印（翌、+1）があれば翌日の時刻として読みます。
+  en: In a list or a table whose items start with a time, such as an itinerary or a programme, one time earlier than the item before it makes the reader check whether it is a typo or a swapped row, and someone turns up at the wrong time. A day's schedule runs from the earliest time, so a time against that order is pointed out. A day ends where a date heading or the date at the start of a row changes. A time past midnight, such as 0:15 after 23:30, is read as the next day's when it is marked so (+1, "next day").
+
+message:
+  ja: 「{time}」が、前後の時刻の並びから外れています（前は「{previous}」）
+  en: "{time} breaks the order of the times around it (after {previous})"
+
+messages:
+  first:
+    ja: 「{time}」が、後の時刻の並びから外れています（次は「{next}」）
+    en: "{time} breaks the order of the times after it (before {next})"
+
+how_to_fix:
+  ja: 時刻を確かめて、書き間違いなら直し、順番が違うなら並べ替えてください。
+  en: Check the time. Correct it if it is a typo, or move the item if the order is wrong.
+
+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: One time out of order in an itinerary or a day's programme
+example:
+  ja:
+    before: |
+      - 09:00 工場の見学
+      - 12:00 昼食
+      - 11:00 報告会
+      - 18:00 懇親会
+    after: |
+      - 09:00 工場の見学
+      - 12:00 昼食
+      - 14:00 報告会
+      - 18:00 懇親会
+  en:
+    before: |
+      - 9:00 AM Tour of the plant
+      - 12:00 PM Lunch
+      - 11:00 AM Report meeting
+      - 6:30 PM Dinner
+    after: |
+      - 9:00 AM Tour of the plant
+      - 12:00 PM Lunch
+      - 2:00 PM Report meeting
+      - 6:30 PM Dinner
+
+not_flagged:
+  ja: 時刻が二つしかない並び、早い順に並ぶ時刻が半分以下の並び（時刻で並べた一覧ではない）、項目の頭でなく文の中に書いた時刻は比べません。夜をまたいで半日より大きく戻る時刻（23:30 の次の 0:15）は、翌日の印が無くても翌日の時刻と読みます。「現地時間」の付いた時刻や時間帯の印が変わる所では一日を区切ります。
+  en: 'A run of only two times, a list where no more than half of the times are in order (not a schedule), and times written inside a sentence rather than at the start of an item are not compared. A time more than half a day earlier than the one before it (0:15 after 23:30) is read as past midnight even without a mark. A "local time" mark, or a change of time zone, starts a new day.'

package/rules/title-length.yaml

@@ -79,8 +79,8 @@ example:
       What every store does during the move in the 2025 financial year.
 
 not_flagged:
-  ja: 見出しの頭の番号（「第2章」「1.」）は数えません。英字の語は一語を二文字と数えます。報告書・プレスリリース・議事録・仕様書・論文は上限が高く、法務・文学・話し言葉のジャンルと、見出しが質問の文になる FAQ では見ません。
-  en: A number label at the head of a heading (Chapter 2, 1.) is not counted. Reports, press releases, minutes, specifications and papers have a higher limit; legal, literary and speech genres, and FAQs (whose headings are questions), do not run this rule.
+  ja: 見出しの頭の番号（「第2章」「1.」）は数えません。英字の語は一語を二文字と数えます。報告書・プレスリリース・議事録・仕様書・論文は上限が高く、法務・文学・話し言葉のジャンルと、見出しが質問の文になる FAQ では見ません。ほかのジャンルでも、？で終わる質問の見出しは、長さが読み手の問いそのものなので見ません。
+  en: A number label at the head of a heading (Chapter 2, 1.) is not counted. Reports, press releases, minutes, specifications and papers have a higher limit; legal, literary and speech genres, and FAQs (whose headings are questions), do not run this rule. In any genre, a heading that ends with a question mark is not counted, since its length is the reader's question.
 level_meaning:
   ja: 題や見出しが {limit} 文字を超えたら指摘
   en: reported when a title or heading runs past {limit} words