Skip to content

docs: clarify MLI framing and length limits - #20

Merged
madflojo merged 1 commit into
americanexpress:mainfrom
madflojo:feature/documentation-updates
Sep 14, 2026
Merged

madflojo merged 1 commit into
americanexpress:mainfrom
madflojo:feature/documentation-updates

Conversation

@madflojo

Copy link
Copy Markdown
Member

Summary

Clarify how SimpleMLI frames stream messages and document each format's supported length range. Replace broken copy-paste snippets with working examples so readers can skip the framing archaeology.

Changes

  • replace invalid README and package examples with correct framing guidance
  • use io.ReadFull for fixed-size MLI and message reads
  • add an executable package example verified by go test
  • document platform-specific 4-byte limits and 2EE embedded-header semantics
  • fix the license link and remove the sunset Go Report Card badge

Validation

  • make build
  • make tests
  • make lint
  • go vet ./...
  • go test -run '^Example$' ./...
  • gofmt
  • git diff --check
  • go doc .

Compatibility

Documentation and tests only. Public API and runtime behavior are unchanged.

Risk

Low. The main review concern is documentation accuracy against existing wire-format validation.

Replace broken snippets with verified stream-framing examples, document format boundaries and 2EE semantics, and remove stale links. Keep future readers out of framing archaeology.
@madflojo
madflojo merged commit 90e919e into americanexpress:main Sep 14, 2026
4 checks passed
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