I only do electronics for a hobby and even then it's only a part of my hobby but lately I've been reading plenty of datasheets for processing components and OMG there are some shockers out there. The latest one, however, takes the cake for the shame file. The datasheet for the BNO080 9DOF from Hillcrestlabs - particularly for I2C comms not only tries to make their own special I2C protocol, they don't even tell you what data to expect from the device.

Apologies, rant finished...

Troy