Bits index convention

[mmaloney-sf]

Responding to #197, this PR adds a sentence explaining that we use a big-endian representation for values, with the index of the LSB as 0 and the MSB as one less than the length.

[mwachs5]

this seems to include changes from another PR?

[seldridge]

Approving the last commit.

This appears to be stacked on #198.

[mmaloney-sf]

Oops.

Fixed and force-pushed.

[dtzSiFive]

s/as/is/?

[programmerjake]

Responding to #197, this PR adds a sentence explaining that we use a big-endian representation

I would call the LSB being bit zero little-endian or LSB0, unrelated to byte endianness.

also, iirc you wanted to have this be a language-wide convention, not just on the bits function.

[mmaloney-sf]

I would call the LSB being bit zero little-endian or LSB0, unrelated to byte endianness.

I meant it more generally as bit endianness. The language I used in the PR should hopefully suffice.

also, iirc you wanted to have this be a language-wide convention, not just on the bits function.

I considered this, but it looked fairly specific to bits. (Although let me know if I overlooked another primop that used this). I'll keep this in the back of my mind and hoist it up if needed.