Skip to content

[Wave 4] Low/info — TR mirror: docs/usermanuals/en/data/ (part 1/2) #813

Open

Description

@cemililik

Wave 4 · 20 finding(s) in 20 fix package(s). Mirror drift across small document pairs in this directory.

Findings

  • DOC-TR12-042 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/all-mask.md: All three of these run the same two detectors: (four commands listed)
    severity Low
    Where. EN docs/usermanuals/en/data/all-mask.md:28-34 · TR docs/usermanuals/tr/data/all-mask.md:28-34
    English text. All three of these run the same two detectors: (four commands listed)
    Turkish text. Aşağıdaki üç çağrı da aynı iki detector'ı çalıştırır: (dört komut listelenmiş)
    Which is correct. Both wrong in the same way: four commands are listed.
    Proposed correction (Turkish text for the -tr page). Aşağıdaki dört çağrı da aynı iki detector'ı çalıştırır:

  • DOC-TR12-043 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/all-mask.md: Some credential shapes (e.g. JWTs) overlap with email-like substrings; running secrets first prevents the email regex from chewing into the mi…
    severity Low
    Where. EN docs/usermanuals/en/data/all-mask.md:43 · TR docs/usermanuals/tr/data/all-mask.md:43
    English text. Some credential shapes (e.g. JWTs) overlap with email-like substrings; running secrets first prevents the email regex from chewing into the middle of a JWT.
    Turkish text. Bazı credential şekilleri (örn. JWT'ler) email-benzeri substring'lerle çakışır; secrets'ı önce çalıştırmak email regex'inin bir JWT'nin ortasını yememesini sağlar.
    Which is correct. Neither. A JWT contains no '@', so the e-mail pattern cannot match inside it. Code (_parser.py --secrets-mask help) gives the real reason: secrets run first so a span is scrubbed under the stronger [REDACTED-SECRET] label.
    Proposed correction (Turkish text for the -tr page). 1. Önce secrets çalıştırılır, böylece iki detector'ın da yakalayabileceği bir span daha güçlü etiket olan [REDACTED-SECRET] ile maskelenir ([REDACTED] ile değil). (JWT/e-posta çakışması gerekçesini kaldırın.)

  • DOC-TR12-044 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/audit.md: "croissant": null
    severity Low
    Where. EN docs/usermanuals/en/data/audit.md:205 · TR docs/usermanuals/tr/data/audit.md:205
    English text. "croissant": null
    Turkish text. "croissant": null
    Which is correct. Code and croissant-card.md:18 / tr croissant-card.md:18: empty dict {}.
    Proposed correction. "croissant": {}

  • DOC-TR12-045 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/audit.md: Both carry total_samples, splits, pii_summary, ...
    severity Low
    Where. EN docs/usermanuals/en/data/audit.md:219 · TR docs/usermanuals/tr/data/audit.md:219
    English text. Both carry total_samples, splits, pii_summary, ...
    Turkish text. Her ikisi de total_samples, splits, ... taşır.
    Which is correct. Key names exist in both, but 'splits' differs in shape (stdout: {name: count}; disk: full per-split dict) and 'croissant' is {} on both.
    Proposed correction (Turkish text for the -tr page). Her ikisi de aynı anahtar adlarını taşır, ancak splits stdout zarfında yalnızca {split: örnek_sayısı}, diskteki raporda ise tam split nesnesidir.

  • DOC-TR12-046 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/audit.md: Configuration Reference — compliance.data_audit_artifact field.
    severity Low · already tracked: KNOWN-OPEN C31-DOC-SCHEMA-PROSE docs/roadmap/phase-16-trust-surface-hardening.md:785-786
    Where. EN docs/usermanuals/en/data/audit.md:266 · TR docs/usermanuals/tr/data/audit.md:265
    English text. Configuration Reference — compliance.data_audit_artifact field.
    Turkish text. Konfigürasyon Referansı — compliance.data_audit_artifact.
    Which is correct. Neither: field does not exist (extra=forbid rejects it).
    Proposed correction (Turkish text for the -tr page). Konfigürasyon Referansı — audit raporu, forgelm audit <corpus> --output <training.output_dir> ile eğitim çıktı dizinine yazıldığında otomatik içeri alınır.

  • DOC-TR12-052 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/deduplication.md: Permutation count and LSH banding are not user-tunable today
    severity Low
    Where. EN docs/usermanuals/en/data/deduplication.md:81,113 · TR docs/usermanuals/tr/data/deduplication.md:81,113
    English text. Permutation count and LSH banding are not user-tunable today
    Turkish text. Permutasyon sayısı ve LSH banding bugün kullanıcı tarafından ayarlanabilir değil
    Which is correct. Permutation count is tunable via Python API audit_dataset(minhash_num_perm=...) (default 128); no CLI flag; banding is library-derived from threshold.
    Proposed correction (Turkish text for the -tr page). Permutasyon sayısı CLI'dan ayarlanamaz (varsayılan 128); Python API'de audit_dataset(minhash_num_perm=...) ile verilebilir. LSH banding datasketch tarafından Jaccard eşiğinden türetilir.

  • DOC-TR12-053 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/ingestion.md: ✓ scanned 47 files ... avg 743 tokens ... wrote data/policies.jsonl (8.2 MB)
    severity Low
    Where. EN docs/usermanuals/en/data/ingestion.md:32-35 · TR docs/usermanuals/tr/data/ingestion.md:32-35
    English text. ✓ scanned 47 files ... avg 743 tokens ... wrote data/policies.jsonl (8.2 MB)
    Turkish text. ✓ 47 dosya tarandı ... ortalama 743 token ... (8.2 MB)
    Which is correct. Neither.
    Proposed correction (Turkish text for the -tr page). Gerçek çıktı biçimini yazın: Ingestion summary / Output JSONL : ... / Files (in/out): processed=47 skipped=0 / Chunks : N / Total chars : N / By format : docx=8, md=27, pdf=12 / Note : PII masking redacted ... / Next: forgelm audit ....

  • DOC-TR12-054 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/ingestion.md: default 200 when --strategy sliding; must be 0 / unset for paragraph or markdown
    severity Low
    Where. EN docs/usermanuals/en/data/ingestion.md:90 · TR docs/usermanuals/tr/data/ingestion.md:89
    English text. default 200 when --strategy sliding; must be 0 / unset for paragraph or markdown
    Turkish text. varsayılan 200; paragraph veya markdown için 0/unset olmalı
    Which is correct. EN matches --help (_parser.py:~220); TR drops the 'when sliding' condition.
    Proposed correction (Turkish text for the -tr page). (--strategy sliding iken varsayılan 200; paragraph veya markdown için 0/unset olmalı — tasarımdan örtüşmesizler)

  • DOC-TR12-055 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/ingestion.md: Run forgelm audit data/output.jsonl to check for cross-split leakage
    severity Low
    Where. EN docs/usermanuals/en/data/ingestion.md:129 · TR docs/usermanuals/tr/data/ingestion.md:128
    English text. Run forgelm audit data/output.jsonl to check for cross-split leakage
    Turkish text. Split-arası sızıntı ... için forgelm audit data/output.jsonl koşturun
    Which is correct. Single file = one split; leakage needs a split directory.
    Proposed correction (Turkish text for the -tr page). Near-duplicate ve maskelemenin kaçırdığı PII için forgelm audit data/output.jsonl; split-arası sızıntı için train/validation/test dosyalarını içeren dizini verin.

  • DOC-TR12-056 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/language-detection.md: For very short rows (<50 characters) ... marks those as unknown
    severity Low
    Where. EN docs/usermanuals/en/data/language-detection.md:34 · TR docs/usermanuals/tr/data/language-detection.md:34
    English text. For very short rows (<50 characters) ... marks those as unknown
    Turkish text. Çok kısa satırlarda (<50 karakter) ... unknown
    Which is correct. Threshold is 20 characters.
    Proposed correction (Turkish text for the -tr page). Çok kısa metinlerde (<20 karakter) dil tespiti güvenilmez olduğundan ForgeLM bunları unknown olarak işaretler.

  • DOC-TR12-057 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/leakage.md: Exact-match index (diagram)
    severity Low
    Where. EN docs/usermanuals/en/data/leakage.md:28 · TR docs/usermanuals/tr/data/leakage.md:28
    English text. Exact-match index (diagram)
    Turkish text. Kesin-eşleşme indeksi (diyagram)
    Which is correct. No separate exact-match index in code (NEW, shared).
    Proposed correction (Turkish text for the -tr page). Diyagramdaki 'Kesin-eşleşme indeksi' kutusunu kaldırın.

  • DOC-TR12-058 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/leakage.md: leakage report is part of the compliance bundle
    severity Low
    Where. EN docs/usermanuals/en/data/leakage.md:118 · TR docs/usermanuals/tr/data/leakage.md:118
    English text. leakage report is part of the compliance bundle
    Turkish text. sızıntı raporu compliance paketinin parçası
    Which is correct. Only when the report is in training.output_dir (otherwise warned as missing).
    Proposed correction (Turkish text for the -tr page). Sızıntı bulguları, forgelm audit --output <training.output_dir> ile yazılan rapor eğitim çıktı dizininde bulunuyorsa governance raporuna dahil edilir; aksi hâlde uyarı loglanır.

  • DOC-TR12-059 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/pii-masking.md: alice@example.com
    severity Low
    Where. EN docs/usermanuals/en/data/pii-masking.md:14 · TR docs/usermanuals/tr/data/pii-masking.md:14
    English text. alice@example.com
    Turkish text. ali@example.com
    Which is correct. Cosmetic.
    Proposed correction. Gerek yok.

  • DOC-TR12-060 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/pii-masking.md: Issuer prefix (Visa/MC/Amex/Discover/JCB/UnionPay)
    severity Low
    Where. EN docs/usermanuals/en/data/pii-masking.md:16 · TR docs/usermanuals/tr/data/pii-masking.md:16
    English text. Issuer prefix (Visa/MC/Amex/Discover/JCB/UnionPay)
    Turkish text. Issuer öneki (Visa/MC/Amex/Discover/JCB/UnionPay)
    Which is correct. List also includes Diners Club and Mir; Maestro deliberately omitted.
    Proposed correction (Turkish text for the -tr page). Issuer öneki (Visa, Mastercard, Amex, Discover, JCB, UnionPay, Diners Club, Mir; Maestro kapsam dışı) + Luhn.

  • DOC-TR12-061 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/pii-masking.md: ✓ masked 18 PII matches across 12,240 chunks ; replacing legitimate words with [EMAIL_REDACTED]
    severity Low
    Where. EN docs/usermanuals/en/data/pii-masking.md:34,58 · TR docs/usermanuals/tr/data/pii-masking.md:34,58
    English text. ✓ masked 18 PII matches across 12,240 chunks ; replacing legitimate words with [EMAIL_REDACTED]
    Turkish text. identical
    Which is correct. Neither: summary note differs; the only placeholder is [REDACTED].
    Proposed correction (Turkish text for the -tr page). Note : PII masking redacted 18 span(s): email=18 biçimini gösterin ve [EMAIL_REDACTED] yerine [REDACTED] yazın.

  • DOC-TR12-062 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/pii-masking.md: the Phase 11.5 incident is documented in the contributor regex standard
    severity Low
    Where. EN docs/usermanuals/en/data/pii-masking.md:60 · TR docs/usermanuals/tr/data/pii-masking.md:60
    English text. the Phase 11.5 incident is documented in the contributor regex standard
    Turkish text. Phase 11.5 olayı ... regex standardında belgelenmiştir
    Which is correct. regex.md only cites review-cycle findings.
    Proposed correction (Turkish text for the -tr page). Gerekçe, katkı rehberindeki regex standardında (Phase 11/11.5/12 inceleme bulguları) özetlenmiştir; 'ML pipeline kesintileri' ifadesini kaldırın.

  • DOC-TR12-063 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/pii-ml.md: the structured identifiers GDPR Article 10 cares about
    severity Low
    Where. EN docs/usermanuals/en/data/pii-ml.md:8 · TR docs/usermanuals/tr/data/pii-ml.md:8
    English text. the structured identifiers GDPR Article 10 cares about
    Turkish text. GDPR Madde 10'un önemsediği yapılandırılmış identifier'ları
    Which is correct. Neither; Art. 10 = criminal convictions; structured identifiers are covered by GDPR Art. 4(1)/5(1)(c), AI Act Art. 10 is the data-governance article.
    Proposed correction (Turkish text for the -tr page). ... AB Yapay Zekâ Tüzüğü Madde 10 (veri yönetişimi) kapsamında değerlendirilen yapılandırılmış identifier'ları ...

  • DOC-TR12-064 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/pii-ml.md: ✓ format: instructions (8,400 rows) / ⚠ PII: 12 emails, 3 phone, 1 IBAN / worst tier: medium
    severity Low
    Where. EN docs/usermanuals/en/data/pii-ml.md:41-44 · TR docs/usermanuals/tr/data/pii-ml.md:41-44
    English text. ✓ format: instructions (8,400 rows) / ⚠ PII: 12 emails, 3 phone, 1 IBAN / worst tier: medium
    Turkish text. ✓ format: instructions (8.400 satır) / ⚠ PII: 12 email, 3 telefon, 1 IBAN / en kötü kat: medium
    Which is correct. Neither.
    Proposed correction (Turkish text for the -tr page). Gerçek çıktı: PII : email=12, person=47, ... ve PII severity : worst tier = medium; örnekten IBAN'ı çıkarın (IBAN critical olup exit 3 verir).

  • DOC-TR12-065 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/pii-ml.md: text = "Alice Williams visits Acme Corp's Berlin office on Monday." (language="en")
    severity Low
    Where. EN docs/usermanuals/en/data/pii-ml.md:115 · TR docs/usermanuals/tr/data/pii-ml.md:115
    English text. text = "Alice Williams visits Acme Corp's Berlin office on Monday." (language="en")
    Turkish text. text = "Alice Williams Pazartesi Acme Corp'un Berlin ofisini ziyaret ediyor." (language="en")
    Which is correct. TR-only change: Turkish sentence passed to the English NER (language='en'); the documented output {'person':1,'organization':1,'location':1} is not guaranteed (page's own pitfall says English NER is weak on Turkish). Unverified (spaCy model not available offline).
    Proposed correction (Turkish text for the -tr page). Örnek metni İngilizce bırakın (EN ile aynı) veya language="xx" kullanın.

  • DOC-TR12-066 (TR mirror, Low) — TR mirror drift in docs/usermanuals/en/data/pii-ml.md: not wired up in v0.7.0
    severity Low
    Where. EN docs/usermanuals/en/data/pii-ml.md:126 · TR docs/usermanuals/tr/data/pii-ml.md:126
    English text. not wired up in v0.7.0
    Turkish text. v0.7.0'da bağlı değildir
    Which is correct. Version stale (current 0.11.1rc1); behaviour (detection-only) still true.
    Proposed correction (Turkish text for the -tr page). Presidio'nun anonymizer modülü ayrı bir bağımlılıktır ve şu anda bağlı değildir.

Done when

  • Every finding above is fixed or closed with a reason (tick it here).
  • Code fixes carry a test; doc fixes update the Turkish mirror in the same PR.

Found by the October 2026 ForgeLM code and documentation review against commit cab2947. Code links point at that commit; line numbers may have moved since. Finding IDs (CR-…, DOC-…, TECH-…) are stable references for this backlog.

Activity

  1. added
    documentationImprovements or additions to documentation
    backlog: knownAlready tracked in docs/roadmap
    i18nEnglish/Turkish documentation mirror
    severity: lowMinor defect, inaccuracy or rough edge
    source: review-2026-10Found by the October 2026 code and documentation review
    wave: 4Roadmap wave 4: low / info / watch, when touching the module
    on Oct 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    backlog: knownAlready tracked in docs/roadmapdocumentationImprovements or additions to documentationi18nEnglish/Turkish documentation mirrorseverity: lowMinor defect, inaccuracy or rough edgesource: review-2026-10Found by the October 2026 code and documentation reviewwave: 4Roadmap wave 4: low / info / watch, when touching the module

    Type

    No type

    Projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions