doc: extend i2c description for pull-up

This PR extends the i2c header file to give a hint on how to use/scale the pull-up resistors