I would like to see the documentation updated for I2C for Wire.requestFrom(address, quantity);
The documentation states:
address: the 7-bit address of the device to request bytes from
quantity: the number of bytes to request
This gives the impression that quantity could at the very least be up to 255.
Which it cannot, its max is set by #define BUFFER_LENGTH 32
So anyone trying to read or write more than BUFFER_LENGTH will have a problem.
The docs should add a note saying something to the effect of the default BUFFER_LENGTH is set at 32, should you wish to change it please see spark_wiring_i2c.h.
I fell that this can cause a possible problem for users that are not going deep into the code but rather just using the cloud IDE.