chaffjs 0.20.0 → 0.21.0

package/rules/bracket-width-consistency.yaml

@@ -0,0 +1,64 @@
+id: bracket-width-consistency
+layer: L1
+status: stable
+how_to_find: mark-consistency
+word_list: bracket-width
+languages: [ja]
+severity: info
+
+name:
+  ja: 丸括弧の全角と半角の混在
+  en: Full-width and half-width parentheses mixed
+
+why:
+  ja: 日本語の文の中で、丸括弧を全角（（））と半角（()）で混ぜて書くと、別々の所から貼り合わせた文書に見えます。どちらが正しいかは決めません。日本語の字に接する括弧だけを数え、文書の中で少ないほうを指します。
+  en: In a Japanese document, parentheses written both full-width （） and half-width () make it look pasted together. chaff does not pick a side; it counts only brackets touching Japanese text and points at the less common way.
+
+message:
+  ja: 括弧を「{mark}」と書いています（この文書はふつう「{usual}」。{of} 箇所のうち {count} 箇所が違う）
+  en: 'The parenthesis "{mark}" here, where the document usually writes "{usual}" ({count} of {of})'
+
+# 少ないほうが 5 箇所以上で、全体の 2 割を超えるとき。書き損じではなく書き方が二通りあるので、1 件にまとめて両方の数を言う。
+messages:
+  mixed:
+    ja: "丸括弧を、全角で {spaced} 箇所、半角で {touching} 箇所書いています。この文書には書き方が二通りあります"
+    en: "Parentheses are written two ways in this document ({spaced} full-width, {touching} half-width)"
+
+how_to_fix:
+  ja: 文書の多いほうの書き方に合わせてください。
+  en: Match the way the rest of the document writes it.
+
+levels: { strict: 1, normal: 1, relaxed: 3 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 日本語の文の中で、丸括弧の全角（（））と半角（()）が混ざっている所
+  en: Full-width （） and half-width () parentheses mixed in one Japanese document
+example:
+  ja:
+    before: |
+      会議（定例）は月曜です。報告（月次）は金曜です。資料(最新版)を配ります。
+    after: |
+      会議（定例）は月曜です。報告（月次）は金曜です。資料（最新版）を配ります。
+
+not_flagged:
+  ja: 日本語の字に接する括弧だけを数えます。英語の中の括弧（f(x)、API(s)）、コード、鉤括弧で引いたものの中は数えません。
+  en: Only brackets touching Japanese text. Brackets in English text (f(x)), code, and 「」 quotations are not counted.
+level_meaning:
+  ja: 少ないほうの書き方が {limit} 箇所あれば指摘
+  en: reported once the less common way appears {limit} times
+rewrite:
+  depth: light
+  ja:
+    direction: 指された括弧だけを、文書の多いほうの書き方（全角か半角）に替えてください。
+    pairs:
+      - before: 資料(最新版)を配ります。
+        after: 資料（最新版）を配ります。
+      - before: 期限（今週金曜)までに出します。
+        after: 期限（今週金曜）までに出します。
+    keep:
+      - 括弧の中の言葉
+    avoid:
+      - 英語やコードの中の括弧まで替える

package/rules/broken-link.yaml

@@ -1,6 +1,6 @@
 id: broken-link
 layer: L1
-status: experimental
+status: stable
 how_to_find: broken-link
 requires: [markdown]
 severity: warning

package/rules/chat-citation-residue.yaml

@@ -1,6 +1,6 @@
 id: chat-citation-residue
 layer: L2
-status: experimental
+status: stable
 how_to_find: chat-citation-residue
 word_list: chat-citation-marker
 severity: warning
@@ -49,6 +49,7 @@ level_meaning:
   ja: 名残の印が {limit} 個あれば指摘
   en: reported once there are {limit}
 rewrite:
+  depth: light
   ja:
     direction: リンク先を開いて、その文の出典になっているかを確かめてから、チャットの印だけを消してください。出典にならないリンクは消し、確かめた出典に替えます。
     pairs:

package/rules/citation-reference-mismatch.yaml

@@ -1,6 +1,6 @@
 id: citation-reference-mismatch
 layer: L3
-status: experimental
+status: stable
 how_to_find: citation-entry
 severity: warning
 
@@ -31,6 +31,11 @@ how_to_fix:
 levels: { strict: error, normal: warning, relaxed: info }
 
 use_for: [academic, legal, docs, literature, speech]
+off_for:
+  legal: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  docs: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  literature: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  speech: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
 
 group: facts
 summary:
@@ -82,6 +87,7 @@ not_flagged:
   ja: 「参考文献」「References」のような見出しの下に文献一覧が無い文書、番号も著者と年も読み取れない文献、文献が一つしか無い一覧は見ません。番号で引く引用と番号の文献、著者と年で引く引用と著者と年の文献は、それぞれの組の中だけで比べます。論文のジャンルでだけ見ます。
   en: 'A document without a list under a heading such as "References", entries that give neither a number nor an author and a year, and a list of one entry are left alone. Numbered citations are compared only with numbered entries, and author-year citations only with author-year entries. Only the academic paper genre runs this rule.'
 rewrite:
+  depth: light
   ja:
     direction: 引用と文献一覧のどちらがずれたのかを書き手に確かめ、ずれたほうを直してください。番号を推測で書き換えず、確かめられないときはその旨を書き手に伝えます。引かない文献は、消すか、引く所を書き手に尋ねます。
     pairs:

package/rules/citation-style-mix.yaml

@@ -1,6 +1,6 @@
 id: citation-style-mix
 layer: L3
-status: experimental
+status: stable
 how_to_find: citation-style
 severity: info
 
@@ -23,6 +23,11 @@ how_to_fix:
 levels: { strict: 3, normal: 2, relaxed: 1 }
 
 use_for: [academic, legal, docs, literature, speech]
+off_for:
+  legal: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  docs: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  literature: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  speech: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
 
 group: consistency
 summary:
@@ -81,6 +86,7 @@ level_meaning:
   ja: 少ないほうの書き方が {limit} 箇所以下のとき指摘
   en: reported when the minority style appears {limit} times or fewer
 rewrite:
+  depth: light
   ja:
     direction: 少数の書き方の引用を、論文で最も多い書き方に書き直してください。番号の方式なら、その文献の文献一覧での番号を使います。番号が分からなければ、書き手に確かめます。
     pairs:

package/rules/clause-chain.yaml

@@ -1,6 +1,6 @@
 id: clause-chain
 layer: L3
-status: experimental
+status: stable
 how_to_find: clause-chain
 requires: [pos]
 languages: [ja]
@@ -24,6 +24,10 @@ how_to_fix:
 
 levels: { strict: 4, normal: 5, relaxed: 7 }
 
+# 法令と契約は、要件を節でつないで一文に書く。既定の上限では group の文書の過半に出たので、測って上げた（spec §21.1）。
+by_genre:
+  legal: { strict: 7, normal: 8, relaxed: 10 }
+
 use_for: [business, technical, blog, legal, docs, academic, literature, speech]
 
 group: readability
@@ -44,6 +48,7 @@ level_meaning:
   ja: 一文の節 {limit} つまで
   en: up to {limit} clauses in one sentence
 rewrite:
+  depth: light
   ja:
     direction: 節のつなぎ目（「〜が、」「〜ので、」「〜て、」）のどこかで文を切り、切った所の関係を次の文の頭で言い直してください。
     pairs:

package/rules/closing-cliche.yaml

@@ -29,6 +29,12 @@ levels:
   relaxed: 2
 
 use_for: [blog, legal, docs, academic, literature, speech]
+off_for:
+  legal: "Legal drafting repeats its terms and its sentence heads on purpose, puts the actor in the passive (shall be deemed), and joins long noun compounds (個人情報取扱事業者). This rule would only flag the form."
+  docs: "A help page repeats its heading in its first line (To upload a file, ...) and states no claims to back up."
+  academic: "Science writes in the passive, hedges its claims on purpose (may, suggest) and cites numbers as its evidence."
+  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."
+  speech: "A speech opens with greetings and closes with thanks: that is its form, not padding."
 
 group: wording
 summary:
@@ -63,6 +69,7 @@ level_meaning:
   ja: 当てはまる結びが {limit} 箇所あれば指摘
   en: reported once there are {limit}
 rewrite:
+  depth: light
   ja:
     direction: 決まり文句の結びを消してください。本文の結論がすでに最後にあれば、そこで終えます。無ければ、本文で分かったことのうち持ち帰ってほしい一つを一文で書きます。
     pairs:

package/rules/code-fence-language-mix.yaml

@@ -0,0 +1,176 @@
+id: code-fence-language-mix
+layer: L1
+status: stable
+how_to_find: code-fence-language
+requires: [markdown]
+severity: info
+
+name:
+  ja: 言語名の無いコードブロックが混ざっている
+  en: Code blocks with and without a language
+
+why:
+  ja: コードブロックに言語名（```bash、```json）を付けると、読み手の画面で色が付き、何の言語かがひと目で分かります。ほとんどのブロックに付けているのに一部だけ無いと、そのブロックだけ色が付かず、付け忘れに見えます。どちらに揃えるかは決めず、少ないほうを指します（markdownlint の MD040 は、すべてのブロックに言語名を求めます）。
+  en: "A language on a code block (```bash, ```json) gives it highlighting on the reader's screen and says at a glance what it is. When most blocks name their language and a few do not, those few show plain and look forgotten. chaff does not decide which way to go; it points at the fewer (markdownlint's MD040 asks for a language on every block)."
+
+message:
+  ja: このコードブロックだけ言語名がありません（言語名のあるブロック {tagged} 個）
+  en: This code block names no language, unlike the others ({tagged} blocks name one)
+
+how_to_fix:
+  ja: 「```」の後ろに言語名を書いてください。出力や平文なら「text」と書きます。
+  en: Add the language after the opening ```. For output or plain text, write "text".
+
+levels: { strict: 3, normal: 2, relaxed: 1 }
+
+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: consistency
+summary:
+  ja: ほとんどのコードブロックに言語名があるのに、一部だけ無い所
+  en: A code block without a language among blocks that name theirs
+example:
+  ja:
+    config: { genre: docs/manual }
+    before: |
+      # 使い方
+
+      インストールします。
+
+      ```bash
+      npm install chaffjs
+      ```
+
+      設定を書きます。
+
+      ```yaml
+      genre: technical/readme
+      ```
+
+      確かめます。
+
+      ```
+      npx chaffjs README.md
+      ```
+    after: |
+      # 使い方
+
+      インストールします。
+
+      ```bash
+      npm install chaffjs
+      ```
+
+      設定を書きます。
+
+      ```yaml
+      genre: technical/readme
+      ```
+
+      確かめます。
+
+      ```bash
+      npx chaffjs README.md
+      ```
+  en:
+    config: { genre: docs/manual }
+    before: |
+      # Usage
+
+      Install it.
+
+      ```bash
+      npm install chaffjs
+      ```
+
+      Write the settings.
+
+      ```yaml
+      genre: technical/readme
+      ```
+
+      Check a file.
+
+      ```
+      npx chaffjs README.md
+      ```
+    after: |
+      # Usage
+
+      Install it.
+
+      ```bash
+      npm install chaffjs
+      ```
+
+      Write the settings.
+
+      ```yaml
+      genre: technical/readme
+      ```
+
+      Check a file.
+
+      ```bash
+      npx chaffjs README.md
+      ```
+
+not_flagged:
+  ja: 字下げだけのコードブロック、引用の中のブロックは見ません。言語名の無いブロックが {limit} 個を超えるとき、または言語名のあるブロックより多いときは、使い分けとみなして指しません。
+  en: Indented code blocks and blocks inside a quotation are not read. When more than {limit} blocks lack a language, or they are as many as those with one, it is taken as a choice and not reported.
+level_meaning:
+  ja: 言語名の無いブロックが {limit} 個以下で、ある方より少ないとき指摘
+  en: reported when {limit} or fewer blocks lack a language and they are fewer than those with one
+rewrite:
+  depth: light
+  ja:
+    direction: 言語名の無いブロックに、中身の言語名を付けてください。コマンドなら bash、設定なら yaml や json、出力や平文なら text です。中身から言語が決められなければ text にします。コードは変えません。
+    pairs:
+      - before: |
+          ```
+          npx chaffjs README.md
+          ```
+        after: |
+          ```bash
+          npx chaffjs README.md
+          ```
+      - before: |
+          ```
+          3 findings
+          ```
+        after: |
+          ```text
+          3 findings
+          ```
+    keep:
+      - ブロックの中身
+    avoid:
+      - 中身と違う言語名を付ける
+  en:
+    direction: Give each block without a language the language of its content. Commands are bash, settings yaml or json, output or plain text text. If the content does not settle it, use text. Do not change the code.
+    pairs:
+      - before: |
+          ```
+          npx chaffjs README.md
+          ```
+        after: |
+          ```bash
+          npx chaffjs README.md
+          ```
+      - before: |
+          ```
+          3 findings
+          ```
+        after: |
+          ```text
+          3 findings
+          ```
+    keep:
+      - the block's content
+    avoid:
+      - naming a language the content is not in

package/rules/colloquial-opener.yaml

@@ -0,0 +1,62 @@
+id: colloquial-opener
+layer: L2
+status: stable
+how_to_find: opener-pile
+word_list: colloquial-opener
+requires: [pos]
+languages: [ja]
+severity: info
+
+name:
+  ja: 文頭の話し言葉の接続詞
+  en: A spoken conjunction opening a sentence
+
+why:
+  ja: 文の頭の「なので」「でも」「だけど」は話し言葉の接続詞です。報告書や案内の中にあると、そこだけ口調が砕けて聞こえます。書き言葉には同じ働きの語（そのため、したがって、しかし）があります。文の途中の「〜なので」は普通の書き方なので見ません。
+  en: In Japanese, なので, でも and だけど at the head of a sentence are spoken conjunctions. In a report or a notice they make that sentence sound casual. Written Japanese has words that do the same job (そのため, しかし). なので inside a sentence is ordinary and not checked.
+
+message:
+  ja: 「{matched}」で始まる文が {count} 個あります（{limit} 個から）
+  en: '{count} {count|sentence opens|sentences open} with "{matched}" ({limit} needed)'
+
+how_to_fix:
+  ja: 書き言葉の接続詞に替えてください（なので → そのため、でも → しかし）。
+  en: Use the written conjunction (なので → そのため, でも → しかし).
+
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [business, technical, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Spoken 全然大丈夫, なので and より in a character's voice; classical verse has a たり that does not list."
+  speech: "Spoken Japanese says 全然大丈夫, opens with なので and greets with より参りました."
+
+group: wording
+summary:
+  ja: 「なので、」「でも、」のような話し言葉の接続詞で始まる文
+  en: A Japanese sentence opening with a spoken conjunction (なので, でも)
+example:
+  ja:
+    before: |
+      在庫が足りません。なので、出荷は来週になります。
+    after: |
+      在庫が足りません。そのため、出荷は来週になります。
+
+not_flagged:
+  ja: 文の途中の「〜なので」「〜でも」と、書き言葉の接続詞（そのため、しかし、したがって）は指しません。ブログ、文芸、話し言葉のジャンルでは動きません。
+  en: なので and でも inside a sentence, and written conjunctions (そのため, しかし), are not reported. Off for blogs, literature and speech.
+level_meaning:
+  ja: 話し言葉の接続詞で始まる文が {limit} 個あれば指摘
+  en: reported from {limit} sentences opening with a spoken conjunction
+rewrite:
+  depth: light
+  ja:
+    direction: 文頭の話し言葉の接続詞を、同じ働きの書き言葉に替えてください（なので → そのため、でも → しかし、だけど → しかし）。
+    pairs:
+      - before: 在庫が足りません。なので、出荷は来週になります。
+        after: 在庫が足りません。そのため、出荷は来週になります。
+      - before: 費用は増えます。でも、作業は半分になります。
+        after: 費用は増えます。しかし、作業は半分になります。
+    keep:
+      - 前の文とのつながりの向き（理由、逆接）
+    avoid:
+      - 接続詞を消して、つながりの向きを読み手に推させる

package/rules/colon-lead-in.yaml

@@ -1,6 +1,6 @@
 id: colon-lead-in
 layer: L1
-status: experimental
+status: stable
 how_to_find: colon-lead-in
 # English human writing hands off to a list after a colon as a matter of course: two in a short self-written English
 # document already passed any limit that the generated-style samples reached. Japanese only until a limit separates them.
@@ -27,6 +27,11 @@ how_to_fix:
 levels: { strict: 1, normal: 2, relaxed: 4 }
 
 use_for: [technical/readme, blog, business, legal, docs, academic, literature, speech]
+off_for:
+  legal: "Legal drafting repeats its terms and its sentence heads on purpose, puts the actor in the passive (shall be deemed), and joins long noun compounds (個人情報取扱事業者). This rule would only flag the form."
+  docs: "A help page repeats its heading in its first line (To upload a file, ...) and states no claims to back up."
+  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."
+  speech: "A speech opens with greetings and closes with thanks: that is its form, not padding."
 
 group: ai-tells
 summary:
@@ -58,6 +63,7 @@ level_meaning:
   ja: コロンで箇条書きへ渡す文が 1000 字あたり {limit} 個まで
   en: "colon lead-ins to lists: up to {limit} per 1000 characters"
 rewrite:
+  depth: structure
   ja:
     direction: コロンで箇条書きへ渡す所のうち、項目が二つか三つで互いに繋がっているものを文に戻してください。手順や部品の一覧は箇条書きのままにします。
     pairs:

package/rules/concrete-evidence-density.yaml

@@ -25,6 +25,12 @@ how_to_fix:
 levels: { strict: 1, normal: 3, relaxed: 6 }
 
 use_for: [blog, business, legal, docs, academic, literature, speech]
+off_for:
+  legal: "Legal drafting repeats its terms and its sentence heads on purpose, puts the actor in the passive (shall be deemed), and joins long noun compounds (個人情報取扱事業者). This rule would only flag the form."
+  docs: "A help page repeats its heading in its first line (To upload a file, ...) and states no claims to back up."
+  academic: "Science writes in the passive, hedges its claims on purpose (may, suggest) and cites numbers as its evidence."
+  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."
+  speech: "A speech opens with greetings and closes with thanks: that is its form, not padding."
 
 group: structure
 summary:

package/rules/contraction-consistency.yaml

@@ -1,6 +1,6 @@
 id: contraction-consistency
 layer: L2
-status: experimental
+status: stable
 how_to_find: contraction-mix
 word_list: contraction
 languages: [en]
@@ -26,6 +26,9 @@ how_to_fix:
 levels: { strict: 4, normal: 2, relaxed: 1 }
 
 use_for: [blog, business, technical, 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."
+  speech/transcript: "A transcript records what was said: its sentences, repeats and register are the speaker's, not the writer's to fix."
 
 group: consistency
 summary:

package/rules/contrast-framing.yaml

@@ -1,6 +1,6 @@
 id: contrast-framing
 layer: L2
-status: experimental
+status: stable
 how_to_find: contrast-framing
 word_list: contrast-frame
 # 打ち消し（it's not）と、それを返す語（it's、but）。後ろに返しが来たときだけ対比の枠になる。
@@ -30,6 +30,11 @@ levels:
   en: { strict: 2, normal: 3, relaxed: 6 }
 
 use_for: [technical/readme, blog, business, legal, docs, academic, literature, speech]
+off_for:
+  legal: "Legal drafting repeats its terms and its sentence heads on purpose, puts the actor in the passive (shall be deemed), and joins long noun compounds (個人情報取扱事業者). This rule would only flag the form."
+  docs: "A help page repeats its heading in its first line (To upload a file, ...) and states no claims to back up."
+  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."
+  speech: "A speech opens with greetings and closes with thanks: that is its form, not padding."
 
 group: ai-tells
 summary:
@@ -56,6 +61,7 @@ level_meaning:
   ja: 1000 字あたり対比の枠 {limit} 個まで
   en: up to {limit} contrast frames per 1000 words
 rewrite:
+  depth: light
   ja:
     direction: 打ち消している側（X）を消し、言いたい側（Y）を普通の文で書いてください。X が誰かの実際の誤解なら、その誤解を書いたうえで一度だけ打ち消してください。
     pairs:

package/rules/cross-doc-duplicate-definition.yaml

@@ -0,0 +1,70 @@
+id: cross-doc-duplicate-definition
+layer: L3
+status: experimental
+how_to_find: cross-doc-duplicate-definition
+# documents: compares the files of one run, so it runs only when chaff is given two or more files, or a folder.
+requires: [structure, documents]
+# The words that make a sentence a definition (をいう, means), per language.
+extra_word_lists: [definition-statement]
+severity: warning
+
+name:
+  ja: ファイルによって違う定義
+  en: One term defined differently in different files
+
+why:
+  ja: 契約書の束や説明書では、同じ語をいくつものファイルで定義することがあります（本契約と別紙、用語集と各ページ）。後から一方だけを直すと、ファイルによって定義が食い違い、どちらの意味で読めばよいか分からなくなります。一度に渡したファイルどうしで、同じ語の定義（「『X』とは、…をいう」"X" means …）の、語の後ろの言葉を比べ、多くのファイルと違う言葉で定義したファイルを指します。全角半角、空白、両端の句読点の違いは問いません。言葉が違っても意味が同じかは機械では決まらないので、確かめる場所を示すだけです。
+  en: 'A bundle of contracts or a manual often defines the same term in several files (the agreement and its schedule, the glossary and the pages). When one is changed later and the other is not, the files disagree on what the term means. Across the files given together, the words after the term in each definition ("X" means …, 「X」とは、…をいう) are compared, and a file that defines the term in other words than most files do is pointed out. Width, spaces and the punctuation at either end do not count. Whether two wordings mean the same is not something a machine can decide, so chaff only shows where to look.'
+
+message:
+  ja: 「{term}」を、一緒に見たほかの {count} ファイルと違う言葉で定義しています（例：{example}）
+  en: '"{term}" is defined in other words than in {count} other {count|file|files} checked with it (as in {example})'
+
+how_to_fix:
+  ja: 定義を一か所（用語集や本契約）にまとめ、ほかのファイルからはそこを参照してください。意味を変えているなら、別の語にします。
+  en: Keep the definition in one place (the glossary, the main agreement) and refer to it from the other files. If the meaning is meant to differ, use a different term.
+
+placeholders:
+  term:
+    ja: 〇〇
+    en: the term
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 同じ語を、ファイルによって違う言葉で定義している所
+  en: The same term defined in other words in different files
+example:
+  ja:
+    other: |
+      # 用語集
+
+      「メンバー」とは、ワークスペースに招かれた人のことです。
+    before: |
+      # はじめに
+
+      「メンバー」とは、料金を払った人のことです。
+    after: |
+      # はじめに
+
+      「メンバー」とは、ワークスペースに招かれた人のことです。
+  en:
+    other: |
+      # Glossary
+
+      "Member" means a person invited to a workspace.
+    before: |
+      # Getting started
+
+      "Member" means a person who pays the fee.
+    after: |
+      # Getting started
+
+      "Member" means a person invited to a workspace.
+
+not_flagged:
+  ja: 範囲を限った定義（「この条において『X』とは」）と、語の後ろに意味を書かない定義（「以下『X』という。」）は比べません。一つのファイルの中で二度定義した語は、最初の定義で比べます（二度目は duplicate-definition が見ます）。全角半角、空白、両端の句読点だけが違う定義は同じとみなします。
+  en: Definitions limited to a part ("In this section, X means") and those that give the meaning before the term ('(the "Vendor")') are not compared. A file that defines a term twice is compared by its first definition (duplicate-definition reports the second). Definitions that differ only in width, spaces or the punctuation at either end are taken as the same.

package/rules/cross-doc-fact-conflict.yaml

@@ -0,0 +1,64 @@
+id: cross-doc-fact-conflict
+layer: L3
+status: experimental
+how_to_find: cross-doc-fact-conflict
+# documents: compares the files of one run, so it runs only when chaff is given two or more files, or a folder.
+requires: [quantities, documents]
+uses: [pos]
+severity: warning
+
+name:
+  ja: ファイルによって違う値が書いてある項目
+  en: One item given different values in different files
+
+why:
+  ja: 説明書や文書の束では、料金・版・締切・問い合わせ先のような同じ項目を、いくつものページに書きます。値を直したときに一つのページだけ直し忘れると、ページによって値が食い違い、読み手はどれを信じればよいか分かりません。一度に渡したファイルどうしで、「項目：値」「項目は値です」と書いた所と表の升を読み、同じ項目名（全角半角、大文字小文字は揃えて比べます）に、同じ単位で違う値を書いたファイルを指します。メールアドレスと、三つ以上に区切った版（2.4.1、v3）も値として読みます。どちらが正しいかは決めず、その値を書いたファイルの少ないほうを指します。
+  en: 'A manual or a bundle of documents repeats the same items, such as a fee, a version, a deadline or a contact address, on page after page. When a value changes and one page is missed, the pages disagree and the reader cannot tell which to trust. Across the files given together, values written as "Item: value" or "The item is value", and table cells, are read; a file that gives the same item name (case and width aside) a different value in the same unit is pointed out. Email addresses and versions of three parts or more (2.4.1, v3) are read as values too. chaff does not decide which is right; it points at the value fewer files give.'
+
+message:
+  ja: 「{label}」が {value} と書かれていますが、一緒に見たほかの {count} ファイルでは {other} です（例：{example}）
+  en: '"{label}" is {value} here, but {other} in {count} other {count|file|files} checked with it (as in {example})'
+
+how_to_fix:
+  ja: どちらの値が正しいかを確かめて、違うほうを直してください。別のもの（別のプラン、別の版）の値なら、項目名にそれを書き分けてください（「プロプランの月額料金」）。
+  en: Check which value is right and correct the other. If they are values of different things (another plan, another release), say so in the item name ("Pro plan monthly fee").
+
+levels: { normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 同じ項目（料金、版、締切、問い合わせ先）に、ファイルによって違う値を書いた所
+  en: The same item (a fee, a version, a deadline, a contact address) given different values in different files
+example:
+  ja:
+    other: |
+      # 料金
+
+      月額料金：1,200円
+    before: |
+      # よくある質問
+
+      月額料金：1,500円
+    after: |
+      # よくある質問
+
+      月額料金：1,200円
+  en:
+    other: |
+      # Pricing
+
+      Monthly fee: $12
+    before: |
+      # Questions
+
+      Monthly fee: $15
+    after: |
+      # Questions
+
+      Monthly fee: $12
+
+not_flagged:
+  ja: 一つのファイルの中で同じ項目に二つ以上の値を書いたファイルは数えません（プランごとの料金のような一覧か、ファイルの中の食い違いで、そちらは fact-conflict が見ます）。ファイルどうしで値が三通り以上に分かれる項目も、一覧と読んで何も言いません。単位の違う値、記録の欄（同じ名前が行の頭に何度も出る欄）、値の後ろに条件が続くもの（「1,200円から」）も比べません。
+  en: A file that gives an item two or more values is not counted (it is a list, such as a fee per plan, or a conflict within the file, which fact-conflict reports). An item whose values split three or more ways across the files is read as a list and left alone. Values in different units, record fields (the same name at the start of many lines), and values followed by a condition ("$12 per seat") are not compared.