chaffjs 0.18.0 → 0.20.0

package/rules/table-header-variant.yaml

@@ -0,0 +1,112 @@
+id: table-header-variant
+layer: L2
+status: experimental
+how_to_find: table-header-variant
+requires: [markdown]
+severity: info
+
+name:
+  ja: 表の見出しの書き方が表ごとに違う
+  en: One table header written two ways
+
+why:
+  ja: 同じ欄を、ある表では「担当者」、別の表では「担当」と書くと、読み手は別の欄かと迷い、表を見比べるときに手が止まります。chaff は表の見出しの行と、二列の表の左の欄（項目名）を集め、幅・大文字小文字・空白・ハイフン・中黒をそろえたうえで、名前を変えない字（者・欄・名・等）を外すと同じになる見出しを、同じ欄の書き方と見ます。そのうえで、文書の中で少ないほうの書き方を指摘します。どちらが正しいかは決めません。
+  en: When one table says "Owner" and another says "Owners" for the same column, the reader wonders whether they are different columns and stops to compare. chaff collects the header row of every table and the left cell of every two-column table (a field name). It treats two headers as one label when they are the same after folding width, case, spaces, hyphens and middle dots and dropping an ending that leaves the meaning alone (s, es). It then points at the less common spelling in the document, without deciding which is right.
+
+message:
+  ja: 表の見出しを「{written}」と書いています（この文書のほかの表は「{usual}」。{of} 箇所のうち {count} 箇所が違う）
+  en: 'The table header "{written}" here, where the document''s other tables write "{usual}" ({count} of {of})'
+
+how_to_fix:
+  ja: 同じ欄なら、文書の多いほうの書き方にそろえてください。本当に別の欄なら、違いが分かる名前にします。
+  en: If it is the same column, write it the way the rest of the document does. If it really is a different column, give it a name that shows the difference.
+
+# 少ないほうの書き方が、その見出しの何パーセントまでなら「混ざっている」と見るか。1 対 1 も指摘する。
+levels: { strict: 50, normal: 50, relaxed: 34 }
+
+use_for: [blog, business, technical, docs, academic, legal, literature, speech]
+
+group: consistency
+summary:
+  ja: 同じ欄の見出しを、表によって「担当者」と「担当」のように書き分けている所
+  en: The same column header written two ways across a document's tables, such as Owner and Owners
+
+example:
+  ja:
+    config: { genre: business/report }
+    before: |
+      | 作業 | 担当者 |
+      | --- | --- |
+      | 発注 | 山田 |
+
+      | 作業 | 担当 |
+      | --- | --- |
+      | 検品 | 鈴木 |
+    after: |
+      | 作業 | 担当者 |
+      | --- | --- |
+      | 発注 | 山田 |
+
+      | 作業 | 担当者 |
+      | --- | --- |
+      | 検品 | 鈴木 |
+  en:
+    config: { genre: business/report }
+    before: |
+      | Task | Owner |
+      | --- | --- |
+      | Order | Kim |
+
+      | Task | Owners |
+      | --- | --- |
+      | Check | Lee |
+    after: |
+      | Task | Owner |
+      | --- | --- |
+      | Order | Kim |
+
+      | Task | Owner |
+      | --- | --- |
+      | Check | Lee |
+
+not_flagged:
+  ja: 文字の無い見出し（数や記号だけ）、コードの例の中の表、見出しの違いが名前を変える場合（「日付」と「日時」）は見ません。二列の表でなければ、左の欄は見出しとして集めません。
+  en: Headers without letters (numbers or symbols only), tables inside a code sample, and headers that differ in meaning (Date and Time) are not compared. The left cell is collected only in two-column tables.
+level_meaning:
+  ja: 少ないほうの書き方が、その見出しの {limit}% 以下のとき指摘
+  en: reported when the less common spelling is {limit}% of the header's uses or less
+rewrite:
+  ja:
+    direction: 同じ欄の見出しを、文書の中で多いほうの書き方にそろえてください。表の中身と並びは変えません。
+    pairs:
+      - before: |
+          | 作業 | 担当 |
+        after: |
+          | 作業 | 担当者 |
+      - before: |
+          | 備考欄 | 金額 |
+        after: |
+          | 備考 | 金額 |
+    keep:
+      - 表の行と列の並び
+      - 升の中身
+    avoid:
+      - 別の欄を同じ名前にする
+      - 多いほうの書き方を少ないほうに合わせる
+  en:
+    direction: Rename the odd header to the spelling the document's other tables use for that column. Keep the cells and their order.
+    pairs:
+      - before: |
+          | Task | Owners |
+        after: |
+          | Task | Owner |
+      - before: |
+          | E-mail | Phone |
+        after: |
+          | Email | Phone |
+    keep:
+      - the rows and columns of every table
+      - the content of every cell
+    avoid:
+      - giving two different columns the same name
+      - changing the common spelling to match the odd one

package/rules/taigen-dome-in-prose.yaml

@@ -44,3 +44,17 @@ not_flagged:
 level_meaning:
   ja: 本文の体言止め {limit} 文まで
   en: up to {limit} noun-ending sentences in the body
+rewrite:
+  ja:
+    direction: 本文で名詞で止めた文に、文書の文体に合わせた述語（です・ます、または、だ・である）を足してください。見出し、箇条書き、表はそのままにします。
+    pairs:
+      - before: 次の課題は費用。
+        after: 次の課題は費用です。
+      - before: 導入は来月から。対象は営業部。
+        after: 導入は来月からです。対象は営業部です。
+    keep:
+      - 見出し、箇条書き、表の体言止め
+      - 文書の文体（です・ます、または、だ・である）
+    avoid:
+      - 文末を「〜となります」「〜になります」に揃えて別の癖を作る
+      - 述語を足すときに強める（「大きな課題です」）

package/rules/teki-overuse.yaml

@@ -0,0 +1,59 @@
+id: teki-overuse
+layer: L3
+status: experimental
+how_to_find: sentence-word-count
+word_list: teki-suffix
+requires: [pos]
+languages: [ja]
+severity: info
+
+name:
+  ja: 「〜的」の多用
+  en: Too many 〜的 words in one sentence
+
+why:
+  ja: 「効果的」「具体的」「積極的」のような「〜的」は、何がどうなのかを言わずに性質だけを指します。一文にいくつも重なると、文がぼやけて中身が見えなくなります。「目的」「的確」のように一語になったものは数えません。
+  en: In Japanese, words made with the suffix 的 (効果的, 具体的) name a quality without saying what or how. Several in one sentence blur it. Words where 的 is part of the word (目的, 的確) are not counted.
+
+message:
+  ja: 一文に「〜的」が {count} 個あります（{limit} 個まで）
+  en: "{count} 〜的 words in one sentence (limit {limit})"
+
+how_to_fix:
+  ja: 「〜的」の所に、何がどうなのかを具体的な言葉で書いてください（効果的に → 半分の時間で）。
+  en: Say what the 〜的 word stands for (効果的に → in half the time).
+
+levels: { strict: 1, normal: 2, relaxed: 3 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: wording
+summary:
+  ja: 一文に「効果的」「具体的」「積極的」のような「〜的」がいくつも重なった所
+  en: A Japanese sentence stacking several 〜的 words (効果的, 具体的)
+example:
+  ja:
+    before: |
+      効果的かつ効率的な施策を、積極的に展開します。
+    after: |
+      問い合わせを半分に減らす施策を、四月から全店で始めます。
+
+not_flagged:
+  ja: 接尾の「的」だけを数えます。「目的」「的確」「標的」のように一語になったものと、鉤括弧で引いたものの中は数えません。
+  en: Only the suffix 的 is counted; words such as 目的 and 的確, and anything in 「」, are not.
+level_meaning:
+  ja: 一文の「〜的」{limit} 個まで
+  en: up to {limit} 〜的 words in a sentence
+rewrite:
+  ja:
+    direction: 「〜的」を、本文にある具体的な事柄（数、期間、対象、やり方）に置き換えてください。本文に無ければ作らず、「〜的」を一つ残すか、書き手に聞きます。
+    pairs:
+      - before: 効果的かつ効率的な施策を、積極的に展開します。
+        after: 問い合わせを半分に減らす施策を、四月から全店で始めます。
+      - before: 抜本的な見直しにより、根本的かつ継続的な改善を図ります。
+        after: 手順を一から見直し、毎月の点検で改善を続けます。
+    keep:
+      - 文が言っている目的と対象
+    avoid:
+      - 「〜的」を別の抽象語（効率のよい、前向きな）に替えるだけ
+      - 本文に無い数や期限を作る

package/rules/title-length.yaml

@@ -0,0 +1,120 @@
+id: title-length
+layer: L1
+status: experimental
+how_to_find: title-length
+requires: [markdown]
+severity: info
+
+name:
+  ja: 題や見出しが長すぎる
+  en: Title or heading too long
+
+why:
+  ja: 題と見出しは、読者が目で拾って、読むかどうかを決める所です。長いと一目で読めず、目次や検索の結果では途中で切れます。日本語は文字で数え、英字の語は一語を二文字と数えます（「Generator」も「API」も同じ一語）。報告書・プレスリリース・議事録・仕様書・論文は正式な題が長くなるので、上限を上げています。
+  en: Readers scan titles and headings to decide what to read. A long one cannot be taken in at a glance, and tables of contents and search results cut it off. English is counted in words. Reports, press releases, minutes, specifications and papers carry long formal titles, so their limit is higher.
+
+message:
+  ja: 見出し「{heading}」は {count} 文字あります（{limit} 文字まで）
+  en: 'The heading "{heading}" runs {count} {count|word|words} (limit {limit})'
+
+messages:
+  title:
+    ja: 題「{heading}」は {count} 文字あります（{limit} 文字まで）
+    en: 'The title "{heading}" runs {count} {count|word|words} (limit {limit})'
+
+how_to_fix:
+  ja: 見出しには名前だけを残し、条件や説明は本文の最初の文へ移してください。括弧の補足（日付、対象、版）は副題か本文に書きます。
+  en: Keep only the name in the heading and move conditions and explanations into the first sentence below it. Put a bracketed aside (a date, an audience, a version) in a subtitle or the text.
+
+# 単位は adapter の lengthUnit。日本語は文字（英字の語は一語を二文字）、英語は語。
+levels:
+  ja: { strict: 30, normal: 40, relaxed: 50 }
+  en: { strict: 10, normal: 14, relaxed: 18 }
+
+# 正式な題が長くなる種類。corpus のその種類の題で、normal が最も長い一握りだけを指すように置いた。
+by_genre:
+  business/report:
+    ja: { strict: 40, normal: 50, relaxed: 60 }
+    en: { strict: 14, normal: 18, relaxed: 22 }
+  business/press-release:
+    ja: { strict: 40, normal: 50, relaxed: 60 }
+    en: { strict: 14, normal: 18, relaxed: 22 }
+  business/meeting-notes:
+    ja: { strict: 40, normal: 50, relaxed: 60 }
+    en: { strict: 14, normal: 18, relaxed: 22 }
+  technical/spec:
+    ja: { strict: 40, normal: 50, relaxed: 60 }
+    en: { strict: 14, normal: 18, relaxed: 22 }
+  academic:
+    ja: { strict: 40, normal: 50, relaxed: 60 }
+    en: { strict: 14, normal: 18, relaxed: 22 }
+
+use_for: [blog, business, technical, docs, academic, legal, literature, speech]
+
+group: readability
+summary:
+  ja: 一目で読めないほど長い題や見出し
+  en: A title or heading too long to take in at a glance
+example:
+  ja:
+    config: { genre: blog/tech }
+    before: |
+      ## 2025年度から始まる新しい在庫管理システムへの移行に伴う各店舗での作業手順と注意点について
+    after: |
+      ## 在庫システムの移行手順
+
+      2025年度の移行で各店舗が行う作業と、注意する点をまとめます。
+  en:
+    config: { genre: blog/tech }
+    before: |
+      ## What every store needs to do during the move to the new inventory system in the 2025 financial year
+    after: |
+      ## Moving to the new inventory system
+
+      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.
+level_meaning:
+  ja: 題や見出しが {limit} 文字を超えたら指摘
+  en: reported when a title or heading runs past {limit} words
+rewrite:
+  ja:
+    direction: 見出しを、その節が何かを言う名前だけに縮めてください。理由・条件・対象・日付は、見出しのすぐ下の最初の文に移します。
+    pairs:
+      - before: |
+          ## 2025年度から始まる新しい在庫管理システムへの移行に伴う各店舗での作業手順と注意点について
+        after: |
+          ## 在庫システムの移行手順
+
+          2025年度の移行で各店舗が行う作業と、注意する点をまとめます。
+      - before: |
+          ## 申込書をオンラインで提出する場合に必要となる書類と提出期限に関する説明
+        after: |
+          ## オンライン申込の書類と期限
+    keep:
+      - 見出しの順番と深さ
+      - 節の中身を指す固有の語
+    avoid:
+      - 縮めるために、節の中身と違う語を見出しにする
+      - 見出しから外した条件を捨てる
+  en:
+    direction: Cut the heading down to a name for what the section is. Move reasons, conditions, audiences and dates into the first sentence under it.
+    pairs:
+      - before: |
+          ## What every store needs to do during the move to the new inventory system in the 2025 financial year
+        after: |
+          ## Moving to the new inventory system
+
+          What every store does during the move in the 2025 financial year.
+      - before: |
+          ## Documents you need and deadlines that apply when you submit your application online through the portal
+        after: |
+          ## Online applications: documents and deadlines
+    keep:
+      - the order and depth of the headings
+      - the specific words that name the section's content
+    avoid:
+      - a shorter heading that names something other than what the section holds
+      - dropping the conditions taken out of the heading

package/rules/topic-predicate-distance.yaml

@@ -0,0 +1,59 @@
+id: topic-predicate-distance
+layer: L3
+status: experimental
+how_to_find: topic-predicate-distance
+requires: [pos]
+languages: [ja]
+severity: info
+
+name:
+  ja: 主題と述語が離れている
+  en: Topic far from its predicate
+
+why:
+  ja: 日本語の文は述語が最後に来るので、「会議は」と主題を出してから述語までが長いと、読み手は主題を覚えたまま、間の修飾や節を全部読み終えるまで「会議は何なのか」を待つことになります。文の長さが上限に収まっていても、主題が文の頭にあって述語が遠ければ起きます。chaff は文の最初の「名詞＋は」から文の終わりの述語までの字数を数えます（述語を厳密に探すのではなく、文の終わりに置く日本語の形を使った近似です）。鉤括弧で引いたものの中は数えません。
+  en: A Japanese sentence puts its predicate last, so after a topic (会議は) the reader waits for everything in between before learning what the topic does. chaff counts the characters from the first noun followed by は to the end of the sentence, where Japanese puts the predicate; it is an approximation, not a parse. Anything quoted in 「」 is not counted.
+
+message:
+  ja: 「は」で出した主題から述語まで {count} 字あります（{limit} 字まで）
+  en: "{count} characters between the topic (は) and the predicate (limit {limit})"
+
+how_to_fix:
+  ja: 主題を述語の近くに動かすか、間に挟んだ説明を別の文にしてください。「会議は、〜のため、〜について、〜した結果、延期になった」は「〜した結果、会議は延期になった」のように。
+  en: Move the topic next to the predicate, or take what stands between them into its own sentence.
+
+levels: { strict: 60, normal: 80, relaxed: 100 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 「会議は」のように主題を出してから、文の終わりの述語まで長く待たせる文
+  en: A Japanese sentence that names its topic (〜は) early and makes the reader wait long for its predicate
+example:
+  ja:
+    before: |
+      来週の定例会議は、新しい担当者の紹介と、先月から続いている予算の見直しと、春に予定している本社の移転の準備と、秋の採用計画の確認と、年末の懇親会の段取りについて話し合う必要があるため、二時間に延長します。
+    after: |
+      来週は、新しい担当者の紹介、先月から続く予算の見直し、春の本社移転の準備、秋の採用計画の確認、年末の懇親会の段取りを話し合います。そのため定例会議は二時間に延長します。
+
+not_flagged:
+  ja: 主題（名詞＋は）の無い文、鉤括弧で引いたものの中、上限までの距離は見ません。英語の文書には使いません。
+  en: Sentences with no topic (noun + は), quotations in 「」, and distances up to the limit are not counted. Not used on English documents.
+level_meaning:
+  ja: 主題から述語まで {limit} 字まで
+  en: up to {limit} characters between the topic and the predicate
+rewrite:
+  ja:
+    direction: 主題（〜は）を述語の近くに動かすか、主題と述語の間に挟んだ説明を前の文に出してください。
+    pairs:
+      - before: 来週の定例会議は、新しい担当者の紹介と、先月から続いている予算の見直しと、春に予定している本社の移転の準備と、秋の採用計画の確認と、年末の懇親会の段取りについて話し合う必要があるため、二時間に延長します。
+        after: 来週は、新しい担当者の紹介、先月から続く予算の見直し、春の本社移転の準備、秋の採用計画の確認、年末の懇親会の段取りを話し合います。そのため定例会議は二時間に延長します。
+      - before: この機能は、利用者が設定画面で通知の頻度や送り先を変えたときに、変更前の設定と変更した日時と変更した人の名前を記録として一週間保存しておき、あとで元に戻せるようにするために使います。
+        after: 利用者が設定画面で通知の頻度や送り先を変えたとき、変更前の設定と日時と変更した人の名前を一週間保存し、あとで元に戻せるようにします。この機能はそのために使います。
+    keep:
+      - 主題と述語の組み合わせ（何が・どうなる）
+      - 間に挟んだ条件や理由
+    avoid:
+      - 間の説明を消す
+      - 主題を消して、何の話なのか分からなくする

package/rules/total-mismatch.yaml

@@ -24,6 +24,7 @@ how_to_fix:
 levels: { normal: error, relaxed: warning }
 
 use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+sources: [de-marneffe-2008]
 
 group: facts
 summary:

package/rules/translationese-density.yaml

@@ -0,0 +1,62 @@
+id: translationese-density
+layer: L2
+status: experimental
+how_to_find: phrase-density
+word_list: translationese
+uses: [pos]
+languages: [ja]
+severity: info
+
+name:
+  ja: 翻訳調が多い
+  en: Too much translationese
+
+why:
+  ja: 「〜を可能にする」「重要な役割を果たす」「〜されることができる」「あなたは」のように英語の構文をそのまま写した言い回しは、一つなら読めますが、重なると文書全体が翻訳の文のように読め、読み手は英語に戻して意味を取ることになります。機械翻訳や英語で考えた下書き、生成した文章に多い形です。一つ一つは誤りではないので、文書の長さあたりの数で見ます。言い回しの一覧は語彙表 translationese にあり、語ごとに日本語として素直な言い方の例が付いています。
+  en: Phrases that copy English syntax into Japanese (を可能にする for "enable", 重要な役割を果たす for "play an important role", されることができる, あなたは for "you") read fine once, but stacked they make the whole document read like a translation, and the reader translates it back to get the meaning. They are common in machine translation, drafts thought out in English, and generated text. None of them is wrong alone, so the rule counts them per length of the document. The phrases are in the lexicon translationese, each with a plainer Japanese way to say it.
+
+message:
+  ja: 「{matched}」など、翻訳調の言い回しが 1000 字あたり {density} 個あります（{limit} 個まで）
+  en: '"{matched}" and other translated phrasings: {density} per 1000 characters (limit {limit})'
+
+how_to_fix:
+  ja: 日本語として素直な言い方に直してください（〜を可能にする → 〜ができる、あなたは → 主語を省く）。
+  en: Say it the way Japanese would (を可能にする → ができる; drop あなたは).
+
+# 人の書いた Qiita の日本語の記事では、1000 字あたり 1 個を超えるものがほとんど無い（測り方は PR に書いた）。
+levels: { strict: 0, normal: 1, relaxed: 2 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: ai-tells
+summary:
+  ja: 「〜を可能にする」「重要な役割を果たす」「あなたは」のような、英語の構文を写した言い回しが多い所
+  en: Japanese that copies English syntax (を可能にする, 重要な役割を果たす, あなたは) too often
+example:
+  ja:
+    pad: true
+    before: |
+      この機能は、あなたが設定を共有することを可能にします。キャッシュは速度において重要な役割を果たします。あなたは設定画面からいつでも変えることができます。
+    after: |
+      この機能を使うと、設定を共有できます。速度にはキャッシュが大きく効きます。設定は設定画面からいつでも変えられます。
+
+not_flagged:
+  ja: 一つ一つは誤りではないので、短い文書（500 字未満）は測りません。人の書いた技術記事でもふつうに使う言い回し（〜を提供する、〜に焦点を当てる、〜することができる）は数えません。文学のジャンルでは既定で止めています（人物を「彼女は」と呼ぶのは小説の書き方です）。
+  en: None of these is wrong alone, so documents shorter than 500 characters are not measured. Phrasings common in human technical writing (を提供する, に焦点を当てる, することができる) are not counted. The literature preset turns it off, since a novel calls its characters 彼女.
+level_meaning:
+  ja: 1000 字あたり翻訳調の言い回し {limit} 個まで
+  en: up to {limit} translated phrasings per 1000 characters
+rewrite:
+  ja:
+    direction: 英語の構文を写した言い回しを、日本語として素直な言い方に直してください。語彙表の語ごとの書き換え（〜を可能にする → 〜ができる）に従い、主語の「あなたは」「彼女は」は省くか名前で呼びます。書いてある事実は変えません。
+    pairs:
+      - before: この機能は、あなたが設定を共有することを可能にします。
+        after: この機能を使うと、設定を共有できます。
+      - before: キャッシュは速度において重要な役割を果たします。
+        after: 速度にはキャッシュが大きく効きます。
+    keep:
+      - 書いてある事実、数、条件
+      - 文書の丁寧さ（です・ます）
+    avoid:
+      - 素直にするついでに中身を削る
+      - 英語の語順のまま語だけを入れ替える

package/rules/undefined-acronym.yaml

@@ -41,6 +41,7 @@ how_to_fix:
 levels: { strict: 1, normal: 3, relaxed: 6 }
 
 use_for: [business, technical, legal, docs, academic, literature, speech]
+sources: [plain-2011, jis-z8301-2019]
 
 group: readability
 summary:

package/rules/unfilled-placeholder.yaml

@@ -10,8 +10,8 @@ name:
   en: Unfilled placeholder
 
 why:
-  ja: 「【会社名】」「[Your Name]」は、雛形や生成した下書きに残る空欄です。文体の好みではなく、埋め忘れです。例として置いた「○○」は正しい書き方なので数えません。
-  en: '"[Your Name]" and "[Insert Date]" are the blanks a template or a generated draft leaves. This is not a matter of style: the blank was never filled.'
+  ja: "「【会社名】」「[Your Name]」「（ここに会社名を書く）」は、雛形や生成した下書きに残る空欄です。値に「TODO: …」「未定」とだけ書いたものも、後で埋めるつもりの空欄です。文体の好みではなく、埋め忘れです。例として置いた「○○」は正しい書き方なので数えません。"
+  en: '"[Your Name]" and "[Insert Date]" are the blanks a template or a generated draft leaves. A value that only says "TODO: …" or "TBD" is a blank too, left to fill in later. This is not a matter of style: the blank was never filled.'
 
 message:
   ja: 「{matched}」が埋まっていません
@@ -21,15 +21,15 @@ how_to_fix:
   ja: 中身を書いてください。例のつもりなら、例だと分かる書き方（例：山田太郎）にしてください。
   en: Fill it in. If it is meant as an example, say so ("for example, Jane Smith").
 
-# 指摘に要る空欄の数。
-levels: { strict: 1, normal: 1, relaxed: 2 }
+# 空欄は 1 つでも埋め忘れなので、段は数ではなく指摘の重さを決める。
+levels: { strict: error, normal: warning, relaxed: info }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
 
 group: slips
 summary:
-  ja: 「【会社名】」「[Your Name]」のように、雛形の空欄が埋まらないまま残っている所
-  en: A template blank left unfilled, such as "[Your Name]" or "[Insert Date]"
+  ja: "「【会社名】」「[Your Name]」「TODO: …」のように、雛形の空欄や後で埋めるつもりの値が埋まらないまま残っている所"
+  en: 'A template blank or a to-do value left unfilled, such as "[Your Name]", "[Insert Date]" or "TODO: …"'
 example:
   ja:
     before: |
@@ -43,8 +43,5 @@ example:
       We can meet on Friday 9 October to go through the quote.
 
 not_flagged:
-  ja: 例として置いた「○○」、Markdown のリンク、脚注の番号、チェック欄、値が続く見出しの札（【氏名】山田）は指しません。
-  en: 'Markdown links and reference definitions, footnote numbers, checkboxes, and a label its value follows ("[Date]: 2024-04-01") are not reported.'
-level_meaning:
-  ja: 空欄が {limit} 箇所あれば指摘
-  en: reported once there are {limit}
+  ja: "例として置いた「○○」、Markdown のリンク、脚注の番号、チェック欄とチェックリストの項目（- [ ] TODO: …）、値が続く見出しの札（【氏名】山田）、コードとコードのコメント（// TODO）、文の中の「未定」（日程は未定です）は指しません。"
+  en: 'Markdown links and reference definitions, footnote numbers, checkboxes and checklist items ("- [ ] TODO: …"), a label its value follows ("[Date]: 2024-04-01"), code and code comments ("// TODO"), and "TBD" inside a sentence ("the date is TBD") are not reported.'

package/rules/unit-mismatch.yaml

@@ -0,0 +1,110 @@
+id: unit-mismatch
+layer: L3
+status: experimental
+how_to_find: unit-mismatch
+requires: [quantities]
+uses: [pos]
+severity: warning
+
+name:
+  ja: 同じ項目の量を違う単位で書いて、換算すると合わない
+  en: One item given in two units that do not convert
+
+why:
+  ja: 「距離：5 km」と「距離：3000 m」のように、同じ項目の量を違う単位で書くと、読み手は換算してどちらが正しいかを確かめることになります。片方の単位を書き換えたときに、数を直し忘れると起きます。「項目：量」「項目は量です」と書いた所と表の升を読み、同じ節の同じ項目で単位の違う量（長さ、重さ、時間、体積、データの量）を換算して比べます。丸めた書き方（1 mile と 1.6 km）は、2% までの差なら合っているとみなします。
+  en: 'When one item is given as "Distance: 5 km" and later "Distance: 3000 m", the reader has to convert to find out which is right. It happens when the unit of one is rewritten and its number is not. Values written as "Item: value" or "The item is value", and table cells, are read; within one section, the same item in two different units (of length, mass, time, volume or data) is converted and compared. A rounded figure (1 mile and 1.6 km) agrees when the difference is within 2%.'
+
+message:
+  ja: "「{label}」が {value} と書かれていますが、同じ節の前の所では {other} で、換算すると合いません"
+  en: '"{label}" is {value} here, but {other} earlier in the same section, and they do not convert'
+
+how_to_fix:
+  ja: どちらの量が正しいかを確かめて、もう一方を換算して直してください。一つの文書では、同じ項目の単位を揃えると読み手が比べやすくなります。
+  en: Check which value is right and convert the other to match. Using one unit for an item throughout a document makes it easier to compare.
+
+levels: { normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 同じ項目の量を、違う単位で書いて換算すると合わない所（距離：5 km と 3000 m）
+  en: 'The same item given in two units that do not convert ("Distance: 5 km" and "3000 m")'
+example:
+  ja:
+    before: |
+      距離：5 km
+
+      - 集合：駅前
+      - 距離：3000 m
+    after: |
+      距離：5 km
+
+      - 集合：駅前
+      - 距離：5000 m
+  en:
+    before: |
+      Distance: 5 km
+
+      - Start: the station
+      - Distance: 3000 m
+    after: |
+      Distance: 5 km
+
+      - Start: the station
+      - Distance: 5000 m
+
+not_flagged:
+  ja: 単位が同じ量（食い違いは fact-conflict が見ます）、種類の違う量（長さと重さ）、違う見出しや違う親の項目の下の量、2% までの差は見ません。GB や MB は 1000 倍でも 1024 倍でも合えば合うとみなします。
+  en: Values in the same unit (fact-conflict looks at those), of different kinds (a length and a mass), under different headings or parent items, and differences within 2% are left alone. GB and MB agree when they match at either 1000 or 1024.
+rewrite:
+  ja:
+    direction: 二つの量のどちらが正しいかを書き手に確かめ、もう一方を換算して直してください。どちらが正しいか文書から決まらないときは、推測で選ばずに書き手に聞いてください。
+    pairs:
+      - before: |
+          距離：5 km
+          （中略）
+          距離：3000 m
+        after: |
+          距離：5 km
+          （中略）
+          距離：5000 m
+      - before: |
+          所要時間は90分です。
+          （中略）
+          所要時間は2時間です。
+        after: |
+          所要時間は90分です。
+          （中略）
+          所要時間は1.5時間です。
+    keep:
+      - 確かめた量
+      - 単位の揃え方
+    avoid:
+      - どちらが正しいかを推測で決める
+      - 換算した数を、元の量より細かい桁で書く
+  en:
+    direction: Ask the writer which value is right, and convert the other to match. If the document does not settle it, ask rather than guess.
+    pairs:
+      - before: |
+          Distance: 5 km
+          (…)
+          Distance: 3000 m
+        after: |
+          Distance: 5 km
+          (…)
+          Distance: 5000 m
+      - before: |
+          The session is 90 minutes.
+          (…)
+          The session is 2 hours.
+        after: |
+          The session is 90 minutes.
+          (…)
+          The session is 1.5 hours.
+    keep:
+      - the value confirmed as right
+      - one unit for the item
+    avoid:
+      - guessing which value is right
+      - writing the converted value with more precision than the original