Skip to content

Docs: Clarify UTF-8 (no BOM) writer encoding policy and interoperability #130

@dborgards

Description

@dborgards

Background

Writer implementations now persist text using UTF-8 without BOM.

Problem

Project docs and historical assumptions still mention/assume DS 306 ASCII behavior in places.
Users need clear guidance on encoding defaults and interoperability expectations.

Proposed change

Document the library's encoding policy (UTF-8 no BOM) and explicitly explain interoperability tradeoffs for strict ASCII toolchains.

Acceptance criteria

  • README/API docs clearly state default output encoding for all writers
  • Compatibility guidance is provided for tools expecting strict ASCII
  • Any intentional deviation from historical behavior is documented

Metadata

Metadata

Assignees

No one assigned

    Labels

    2026-03-phase-4Not assigned to roadmap phase yet

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions