Skip to content

Document platform endianness support - #11056

Open
sdf-jkl wants to merge 1 commit into
apache:mainfrom
sdf-jkl:docs/platform-endianness
Open

Document platform endianness support#11056
sdf-jkl wants to merge 1 commit into
apache:mainfrom
sdf-jkl:docs/platform-endianness

Conversation

@sdf-jkl

@sdf-jkl sdf-jkl commented Sep 10, 2026

Copy link
Copy Markdown
Member

Which issue does this PR close?

Related to #6917.

Rationale for this change

The endianness support and testing expectations discussed in #6917 are not currently stated in the repository's user documentation. Users should be able to find these limitations when choosing a crate.

What changes are included in this PR?

Add a Platform Support section to the root README and the API landing page of every published library crate. It states that only little-endian platforms are officially supported and tested in CI, while big-endian platforms are untested and may not work correctly. Big-endian fixes are welcome on a best-effort basis, with no compatibility guarantee.

Each crate includes the full paragraph because it can be consumed independently.

Are these changes tested?

Documentation only. cargo fmt --all -- --check and git diff --check pass. Verified that the root README and all 25 published library crates contain identical policy wording.

Are there any user-facing changes?

Documents the platform support and testing expectations. No API or runtime behavior changes.

@sdf-jkl
sdf-jkl marked this pull request as ready for review September 10, 2026 21:38
@sdf-jkl

sdf-jkl commented Sep 10, 2026

Copy link
Copy Markdown
Member Author

@alamb @Jefffrey fyi

@Rich-T-kid Rich-T-kid left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it may be better to just place this comment in the readme or in some other centralized place instead of repeating it

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants