chaffjs 0.28.0 → 0.30.0

package/rules/required-listed-as-preferred.yaml

@@ -0,0 +1,102 @@
+id: required-listed-as-preferred
+layer: L3
+status: stable
+how_to_find: requirement-lists
+# The headings and labels come from requirement-heading; a length of experience is read with requirement-length-unit,
+# requirement-length-word and number-word, and requirement-item-ending is taken off the end of an item.
+languages: [ja, en]
+severity: warning
+
+name:
+  ja: 必須の条件を歓迎の条件にも挙げている
+  en: A required skill listed again as preferred
+
+why:
+  ja: 求人の「必須」に挙げた資格や経験を「歓迎」にも挙げると、読み手はそれが必ず要るのか、あれば良いだけなのかが分からず、応募するかどうかを決められません。どちらかの項目を書き換えたつもりで、別の行を写したときに起きます。必須（必須スキル、応募資格）と歓迎（歓迎スキル、尚可）の見出しや札の下の箇条書きを比べ、同じ項目が両方にあれば、歓迎のほうを指します。大文字と小文字、全角と半角、記号、項目の終わりの「の方」「こと」は区別しません。経験の長さ（3年以上）は外して比べ、歓迎のほうが長い経験を求めていなければ同じ項目と読みます。
+  en: 'When a posting lists a qualification under "Required" and again under "Preferred", the reader cannot tell whether it is a must or only welcome, and cannot decide whether to apply. It happens when one line is copied in place of the one that was meant to be rewritten. The list items under a required heading or label (Required, Requirements, Must have) are compared with those under a preferred one (Preferred, Nice to have, Bonus points), and an item in both is pointed out where it is preferred. Case, full and half width and punctuation are ignored. A length of experience (3+ years) is taken out before comparing, and the two are read as the same item unless the preferred one asks for more experience.'
+
+message:
+  ja: 「{item}」は必須の条件（{required}）にも挙げています
+  en: '"{item}" is also listed as required ({required})'
+
+how_to_fix:
+  ja: 必ず要るなら歓迎から消し、あれば良いだけなら必須から消してください。歓迎で上の水準を求めるなら、「5年以上」のように違いを書いてください。
+  en: Remove it from the preferred list if it is a must, or from the required list if it is only welcome. If the preferred item asks for more, say how much more, such as "5+ years".
+
+# chaff explain と規則の一覧には指摘が無いので、{item} と {required} をこう読ませる。
+placeholders:
+  item:
+    ja: 〇〇
+    en: the item
+  required:
+    ja: 必須の項目
+    en: the required item
+
+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: structure
+summary:
+  ja: 求人で、必須に挙げた資格や経験を歓迎にも挙げている所
+  en: A skill or qualification in a job posting listed both as required and as preferred
+example:
+  ja:
+    before: |
+      # 求人：経理スタッフ
+
+      ## 必須
+
+      - 日商簿記2級以上
+      - 経理の実務経験3年以上
+
+      ## 歓迎
+
+      - 日商簿記2級以上
+      - 英語の書類を読めること
+    after: |
+      # 求人：経理スタッフ
+
+      ## 必須
+
+      - 日商簿記2級以上
+      - 経理の実務経験3年以上
+
+      ## 歓迎
+
+      - 連結決算の経験
+      - 英語の書類を読めること
+  en:
+    before: |
+      # Job posting: Accounts Assistant
+
+      ## Required
+
+      - A degree in accounting or finance
+      - At least three years of bookkeeping experience
+
+      ## Preferred
+
+      - At least three years of bookkeeping experience
+      - Reading business documents in Japanese
+    after: |
+      # Job posting: Accounts Assistant
+
+      ## Required
+
+      - A degree in accounting or finance
+      - At least three years of bookkeeping experience
+
+      ## Preferred
+
+      - Experience with consolidated accounts
+      - Reading business documents in Japanese
+
+not_flagged:
+  ja: 歓迎のほうが長い経験を求める項目（必須「Python」、歓迎「Python 5年以上」）は、上の水準を歓迎していると読んで指しません。違う言葉で同じことを言う項目（「簿記2級」と「日商簿記2級」）、資格の級の違い（「2級以上」と「1級」）、表に書いた条件、一つの行に「必須：Python、Go」のように並べた条件は比べません。見出しや札の無い箇条書きは読みません。
+  en: 'A preferred item asking for more experience (required "Python", preferred "5+ years of Python") is read as welcoming a higher level, and is not pointed out. Two items saying the same thing in other words ("bookkeeping" and "accounting"), different grades of a certificate, conditions written in a table, and conditions run together on one line ("Required: Python, Go") are not compared. A list without a required or preferred heading or label is not read.'
+level_meaning:
+  ja: 必須と歓迎の両方に同じ項目があるとき指摘
+  en: reported when the same item is listed as required and as preferred

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/return-type-mismatch.yaml

@@ -0,0 +1,79 @@
+id: return-type-mismatch
+layer: L1
+status: stable
+how_to_find: return-type
+# The words come from the return-label (Returns, 戻り値), return-verb (returns, 返します), return-subject (は),
+# return-type-word (string, 文字列), return-clause (when, とき) and return-item (per, ごと) lexicons.
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 戻り値の型が二通りに書かれている
+  en: A return type stated two ways
+
+why:
+  ja: API リファレンスで、関数のシグネチャと、「戻り値：」の行や表や文が違う型を返すと書いていると、読み手はどちらを信じてよいか分からず、返った値を間違った型として扱います。戻り値を変えたときに、片方だけを直すと起きます。コードブロックのシグネチャ（戻り値の型が付いたもの）を基準に、同じ見出しの下の「戻り値：」の行、戻り値の列を持つ表の行、関数名を主語にして「返します」と言う文を、同じ名前の関数どうしで比べます。Array<string> と string[] のような同じ型の別の書き方は同じと読み、「文字列」「数値」のような語は種類として比べます。
+  en: When an API reference's signature and a "Returns:" line, a table or a sentence say a function returns different types, the reader cannot tell which to trust and handles the value as the wrong type. It happens when a return type is changed in one place only. The signature in a code block (one with a return type) is the reference; a "Returns:" line under the same heading, a row of a table with a return column, and a sentence whose subject is the function's name and whose verb is "returns" are compared with it, for the same function only. Two spellings of one type (Array<string> and string[]) are the same, and words such as "string" or "number" are compared as kinds of value.
+
+message:
+  ja: 「{function}」の戻り値が「{stated}」と書かれていますが、シグネチャでは「{signature}」です
+  en: "`{function}` is said to return {stated} here, but its signature returns `{signature}`"
+
+how_to_fix:
+  ja: 実際の戻り値を確かめて、シグネチャか説明のどちらかを直してください。
+  en: Check what the function really returns, and correct the signature or the description.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [technical, docs, blog, legal, academic, literature, speech]
+off_for:
+  legal: "Signatures and return types belong to technical writing."
+  academic: "Signatures and return types belong to technical writing."
+  literature: "Signatures and return types belong to technical writing."
+  speech: "Signatures and return types belong to technical writing."
+
+group: facts
+summary:
+  ja: API リファレンスで、シグネチャと説明が違う戻り値の型を言う所
+  en: A return type that the signature and the description state differently
+example:
+  ja:
+    config: { genre: technical/readme }
+    before: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      measure は、幅を "12" のような文字列で返します。
+    after: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      measure は、幅を桁数の数値で返します。
+  en:
+    config: { genre: technical/readme }
+    before: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      measure returns the width as a string such as "12".
+    after: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      measure returns the width as a number of columns.
+
+not_flagged:
+  ja: シグネチャの無い関数、別の名前の関数、引数の違う二つの宣言（オーバーロード。どちらかに合えば合っているとします）、型を読めないもの（オブジェクトの型、括弧で囲んだ型）、型の名前の無い文、二つの種類を言う文（文字列の配列）、条件の節の中の種類の語（「文字列が空のときに true を返します」の文字列）、一つ分を言う語が続く種類の語（「文字列ごとに」の文字列）、null だけを言う文（いつ null が返るかの説明）、ユニオンの一部だけを言うもの（number | null に対する number）、Promise やクラス名のように種類の語では比べられない型は見ません。「返していました」「返しません」のような過去や否定、関数名が主語でない文、名前と動詞の間に語を挟んだ英語の文（measure usually returns）、二つ以上の関数を宣言した見出しの下の「戻り値：」の行、コードブロックの中は読みません。
+  en: 'A function with no signature, a different function, two declarations with different parameters (overloads; a statement that fits either is fine), a type that cannot be read (an object type, a type in brackets), a sentence with no type in it, a sentence naming two kinds (an array of strings), a kind word inside a clause about when (string in "returns true when the string is empty"), a kind word naming one item ("one string per line"), a sentence naming only null (when null comes back), part of a union (number against number | null), and a type that a kind word cannot be compared with (Promise, a class name) are not reported. The past (returned), a sentence whose subject is not the function''s name or that puts a word between the name and returns (measure usually returns), a "Returns:" line under a heading that declares two or more functions, and code blocks are not read.'

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

package/rules/ui-label-variant.yaml

@@ -0,0 +1,70 @@
+id: ui-label-variant
+layer: L3
+status: stable
+how_to_find: ui-label
+# A label is text in bold or in ［］; the words a label is written with or without come from the label-particle lexicon.
+languages: [ja, en]
+severity: info
+
+name:
+  ja: 二通りに書いた画面の札
+  en: Screen label written two ways
+
+why:
+  ja: 手順書で同じボタンを［復元を開始］とも［復元開始］とも書くと、読み手は画面に二つのボタンがあるのかと探します。画面の文字と同じ綴りで書くのが手順書の決まりです。画面の文言が変わったあとに一部だけ直すと起きます。太字か［］で囲んだ札のうち、大文字・小文字、空白、「を」「の」だけが違う二つを同じ札と見て、少ないほうを指します。
+  en: "When a manual writes the same button as **Start Restore** in one step and **Start restore** in another, the reader looks for two buttons. A manual spells every label exactly as the screen does. It happens when the screen's wording changes and only some steps are updated. Labels in bold (or in ［］) that differ only in case, spaces or a particle are read as one label, and the form written less often is pointed out."
+
+message:
+  ja: 「{written}」は、ほかの所では「{usual}」と書いています
+  en: '"{written}" is written as "{usual}" elsewhere'
+
+how_to_fix:
+  ja: 画面の文字を確かめて、どちらか一方にそろえてください。
+  en: Check the screen and use its spelling in every step.
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [technical, docs, blog, legal, academic, literature, speech]
+off_for:
+  legal: "Screen labels in bold or in brackets are a convention of manuals and technical writing."
+  academic: "Screen labels in bold or in brackets are a convention of manuals and technical writing."
+  literature: "Screen labels in bold or in brackets are a convention of manuals and technical writing."
+  speech: "Screen labels in bold or in brackets are a convention of manuals and technical writing."
+
+group: consistency
+summary:
+  ja: 太字や［］の画面の札で、大文字・小文字や空白、「を」「の」だけが違う二通りの書き方
+  en: A bold or bracketed screen label written two ways that differ only in case, spaces or a particle
+example:
+  ja:
+    config: { genre: docs/manual }
+    before: |
+      # 復元する
+
+      ［復元を開始］を押します。終わらないときは、もう一度［復元を開始］を押します。
+
+      失敗したら、前のバックアップを選んで［復元開始］を押します。
+    after: |
+      # 復元する
+
+      ［復元を開始］を押します。終わらないときは、もう一度［復元を開始］を押します。
+
+      失敗したら、前のバックアップを選んで［復元を開始］を押します。
+  en:
+    config: { genre: docs/manual }
+    before: |
+      # Restore
+
+      Click **Start Restore**. If nothing happens, click **Start Restore** again.
+
+      If it fails, select the previous backup and click **Start restore**.
+    after: |
+      # Restore
+
+      Click **Start Restore**. If nothing happens, click **Start Restore** again.
+
+      If it fails, select the previous backup and click **Start Restore**.
+
+not_flagged:
+  ja: 太字か［］で囲んだ札だけを見ます。かぎ括弧の語、コードの中の語、字の違う札（［保存］と［上書き保存］）、最初の一字の大文字・小文字だけが違う強調（**Note** と **note**）、語の中の「の」（［その他］）は比べません。技術文書・手順書・ブログでだけ動きます。
+  en: "Only labels in bold or in ［］ are compared. Quoted words, code, labels with different words (**Save** and **Save As**), and emphasis differing only in its first letter's case (**Note** and **note**) are not. Technical documents, manuals and blogs only."

package/rules/unbalanced-bracket.yaml

@@ -9,8 +9,8 @@ name:
   en: Unbalanced bracket
 
 why:
-  ja: 閉じ忘れた「（」や、開きの無い「」」があると、読み手はどこまでが括弧の中なのか分からなくなります。全角の「（」を半角の「)」で閉じるのも、書き換えの途中で残った印です。見出しで区切った節ごとに、「」『』（）()［］[]【】〔〕〈〉《》“” の組を数えます。詩の連や長い引用は段落をまたぐので、段落を越えて組にします。行の頭や空白の後ろの「1)」「a)」「事例）」のような三文字までの番号の印と数の後ろの「）」、コードと URL は数えません。英語の小説のように、次の段落も同じ開きで始まるなら、閉じない開きは続きとして数えません。
-  en: A "(" never closed, or a ")" never opened, leaves the reader unsure where the aside ends. A full-width "（" closed by a half-width ")" is left over from an edit too. Brackets are paired within each section under a heading ((), [], “”, and the Japanese 「」『』（）［］【】〔〕〈〉《》), across paragraphs, since a stanza or a long quotation may span several. A short label of up to three characters such as "1)", "a)" or "iv)" at the start of a line or after a space, a ")" right after a number, code and URLs are not counted. An opening quotation mark carried into a paragraph that opens with the same mark, as in fiction, is not counted.
+  ja: 閉じ忘れた「（」や、開きの無い「」」があると、読み手はどこまでが括弧の中なのか分からなくなります。全角の「（」を半角の「)」で閉じるのも、書き換えの途中で残った印です。見出しで区切った節ごとに、「」『』（）()［］[]【】〔〕〈〉《》“” の組を数えます。詩の連や長い引用は段落をまたぐので、段落を越えて組にします。行の頭や空白の後ろの「1)」「a)」「事例）」のような三文字までの番号の印と数の後ろの「）」、括弧の中の番号の印（「（…以下、事例5）まで同じ。）」の「事例5）」。同じ字の印を行の頭でも使っていて、同じ行の後ろの閉じで括弧が閉じるときに限る）、コードと URL、引用の閉じのすぐ前の開き（法令の読替えの「取締役（」とあるのは）は数えません。英語の小説のように、次の段落も同じ開きで始まるなら、閉じない開きは続きとして数えません。
+  en: A "(" never closed, or a ")" never opened, leaves the reader unsure where the aside ends. A full-width "（" closed by a half-width ")" is left over from an edit too. Brackets are paired within each section under a heading ((), [], “”, and the Japanese 「」『』（）［］【】〔〕〈〉《》), across paragraphs, since a stanza or a long quotation may span several. A short label of up to three characters such as "1)", "a)" or "iv)" at the start of a line or after a space, a ")" right after a number, a numbered label inside an aside ("A3)" in "(see the notes; A3) and more)", when the same label is used at the start of a line and later closes on the same line still close the aside), code, URLs, and an opening bracket quoted as the last character of a quotation (「取締役（」, as statutes quote the text they amend) are not counted. An opening quotation mark carried into a paragraph that opens with the same mark, as in fiction, is not counted.
 
 message:
   ja: 「{mark}」が組になっていません
@@ -52,5 +52,5 @@ example:
       The plan (see below) is ready.
 
 not_flagged:
-  ja: 行の頭や空白の後ろの「1)」「a)」「事例）」のような三文字までの番号の印、数の後ろの「）」、コードと URL は数えません。段落をまたいで閉じる括弧と、次の段落を同じ引用符で始める台詞も指しません。
-  en: Labels of up to three characters such as "1)" or "a)" at the start of a line or after a space, a ")" right after a number, code and URLs are not counted. A bracket closed in a later paragraph, and a quotation carried into a paragraph that opens with the same mark, are not reported.
+  ja: 行の頭や空白の後ろの「1)」「a)」「事例）」のような三文字までの番号の印、数の後ろの「）」、行の頭でも使う番号の印を括弧の中に書いたもの（「以下、事例5）まで同じ。」）、コードと URL は数えません。段落をまたいで閉じる括弧と、次の段落を同じ引用符で始める台詞も指しません。
+  en: Labels of up to three characters such as "1)" or "a)" at the start of a line or after a space, a ")" right after a number, a numbered label also used at the start of a line, written inside an aside ("(see the notes; A3) and more)"), code and URLs are not counted. A bracket closed in a later paragraph, and a quotation carried into a paragraph that opens with the same mark, are not reported.

package/rules/uncomparable-graded.yaml

@@ -4,7 +4,7 @@ status: stable
 how_to_find: phrase-match
 word_list: uncomparable-graded
 requires: [pos]
-languages: [en]
+languages: [ja, en]
 severity: info
 
 name:
@@ -12,16 +12,16 @@ name:
   en: An uncomparable adjective given a degree
 
 why:
-  ja: 英語の「unique」「unanimous」「impossible」は、そうであるかないかの二つしかない状態を言います。「very unique」「more unanimous」と程度を付けても何も足されず、読み手は書き手が語の意味を確かめていないと受け取ります。語の一覧は言語ごとの語彙表にあります。
-  en: '"Unique", "unanimous" and "impossible" name a state that holds or does not. "Very unique" or "more unanimous" adds nothing, and tells the reader the writer did not weigh the word. The phrases are listed in the lexicon.'
+  ja: 「最適」「完璧」（英語の unique、unanimous、impossible）は、一番であるか・欠けが無いかを言う語で、程度がありません。「より最適な」「とても完璧」（very unique、more unanimous）と程度を付けても何も足されず、読み手は書き手が語の意味を確かめていないと受け取ります。語の一覧は言語ごとの語彙表にあります。
+  en: '"Unique", "unanimous" and "impossible" (最適, 完璧) name a state that holds or does not. "Very unique" or "more unanimous" (より最適な, とても完璧) adds nothing, and tells the reader the writer did not weigh the word. The phrases are listed in the lexicon.'
 
 message:
-  ja: 「{matched}」は、程度の無い形容詞に程度を付けています
+  ja: 「{matched}」は、程度の無い語に程度を付けています
   en: '"{matched}" grades an adjective that has no degrees'
 
 how_to_fix:
-  ja: 程度の語を外すか、本当に言いたい程度の言える語に替えてください（very unique → unique、または unusual）。
-  en: Drop the grade, or use a word that has degrees ("very unique" → "unique", or "unusual").
+  ja: 程度の語を外すか、本当に言いたい程度の言える語に替えてください（より最適な → 最適な、または より適した。very unique → unique、または unusual）。
+  en: Drop the grade, or use a word that has degrees ("very unique" → "unique", or "unusual"; より最適な → 最適な, or より適した).
 
 levels: { strict: 1, normal: 1, relaxed: 2 }
 
@@ -31,9 +31,14 @@ off_for:
 
 group: wording
 summary:
-  ja: 英語で、「very unique」「more unanimous」のように、程度の無い形容詞に付けた程度
-  en: A degree given to an adjective that has none, such as "very unique" or "more unanimous"
+  ja: 「より最適な」「とても完璧」（very unique、more unanimous）のように、程度の無い語に付けた程度
+  en: A degree given to an adjective that has none, such as "very unique" or "more unanimous" (より最適な, とても完璧)
 example:
+  ja:
+    before: |
+      より最適な案を選びました。
+    after: |
+      最適な案を選びました。
   en:
     before: |
       The design is very unique.
@@ -41,14 +46,28 @@ example:
       The design is unusual.
 
 not_flagged:
-  ja: 一覧にある組み合わせだけを見ます。「almost」「nearly」のように近さを言う語（almost unique、nearly impossible）は指しません。英語の文書だけで動き、文学のジャンルは対象にしません。
-  en: Only the pairs on chaff's list are checked. Words that say how close ("almost unique", "nearly impossible") are not reported. English documents only; literature is not checked.
+  ja: 一覧にある組み合わせだけを見ます。「ほぼ完璧」（almost unique、nearly impossible）のように近さを言う語は指しません。「最も最適」「一番ベスト」のように最上を重ねた形は redundant-expression が見ます。「より最適化する」は指しません。文学のジャンルは対象にしません。
+  en: Only the pairs on chaff's list are checked. Words that say how close ("almost unique", "nearly impossible", ほぼ完璧) are not reported. A superlative stacked on a superlative (最も最適) is redundant-expression's, and より最適化する (optimise further) is not reported. Literature is not checked.
 level_meaning:
   ja: 当てはまる言い回しが {limit} 箇所あれば指摘
   en: reported once there are {limit}
 sources: [proselint]
 rewrite:
   depth: light
+  ja:
+    direction: 程度の語（より、とても、非常に）を外してください。程度を言いたいのなら、程度のある語に替えます（より最適な → より適した）。文のほかの所は変えません。
+    pairs:
+      - before: より最適な案を選びました。
+        after: 最適な案を選びました。
+      - before: 仕上がりはとても完璧でした。
+        after: 仕上がりは完璧でした。
+      - before: 前の版より最善の方法です。
+        after: 前の版より良い方法です。
+    keep:
+      - 文の主張
+      - 文のほかの所
+    avoid:
+      - 別の程度の語（本当に最適）に替えるだけ
   en:
     direction: Drop the grade before the adjective, or swap the adjective for one that has degrees when a degree is meant. Change nothing else in the sentence.
     pairs: