DOC: document the pitfalls of different byte orders