DOC: document the pitfalls of different byte orders

closes #3778 .