Skip to content

English docs policy and Phase 2 DocMark ⇄ DOCX roundtrip - #3

Merged
digiogithub merged 4 commits into
mainfrom
copilot/translate-documentation-to-english
Aug 2, 2026
Merged

digiogithub merged 4 commits into
mainfrom
copilot/translate-documentation-to-english

Conversation

Copilot AI commented Aug 2, 2026 •

Copy link
Copy Markdown
Contributor

Project docs were Spanish-only with no English agent contract; Phase 2 (DocMark parse, DOCX write, roundtrip) was still open after Phases 0–1.

Documentation

  • Translate AGENTS.md, README, docs/, kb/, corpus/README to English
  • Rename design docs to English paths (development-plan, architecture, docmark-specification, technical-analysis, spikes)
  • Require English for docs and code comments in AGENTS.md; mark Phases 0–2 core closed

DocMark parser (docsai-docmark)

  • Add parse / parse_with_base (YAML subset, front matter, body/inlines) as serializer inverse
  • Peel paragraph attrs only when whitespace precedes {...} so tight spans round-trip:
**negrita** *cursiva* ~~tachado~~ [subrayado]{.underline}
  • Golden serialize(parse(md)) for basic-text, basic-styles, nested-lists

DOCX writer (docsai-office)

  • Hand-written OOXML package writer (write_docx); WRITABLE = [Docx]
  • Stable LineHeight::Multiple (thousandths) ↔ OOXML auto (240ths) rounding

Convert + CLI

  • SUPPORT: Docx/DocMark read+write; bidirectional convert_file
  • roundtrip_file → RoundtripOutcome; CLI roundtrip (-o, --json)

Out of scope / known gaps

Floating DrawingML, full footnote parts, text-box fidelity; corpus-wide Office idempotence beyond basic-text. Phase 3 (xlsx) not started.

Copilot AI changed the title feat: English docs policy and Phase 2 DocMark ⇄ DOCX roundtrip English docs policy and Phase 2 DocMark ⇄ DOCX roundtrip Aug 2, 2026
Copilot AI requested a review from digiogithub August 2, 2026 08:18
@digiogithub
digiogithub marked this pull request as ready for review August 2, 2026 08:25
@digiogithub
digiogithub merged commit 5680ca0 into main Aug 2, 2026
3 of 4 checks passed
@digiogithub
digiogithub deleted the copilot/translate-documentation-to-english branch August 2, 2026 08:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants