Bluetooth: doc: Add warning for bt_data_parse

The fact that the function consumed its argument was not clear previously.

Fixes #47676.

The alternative is to change the API to not consume the data, but as it's
an API change, I suggest we only add the warning.

Signed-off-by: Jonathan Rico <jonathan.rico@nordicsemi.no>