DOC: document the pitfalls of different byte orders
Merge pull request #3780 from cpcloud/doc-the-endian-stuff

DOC: document the pitfalls of different byte orders