documentation: Bit handling gotchas explained

Just a few things that took me an unreasonable amount of time to figure out.