Bluetooth: BAP: Fix bad documentation in bap.h

Add missing of documentation of BT_BAP_BASS_MAX_SUBGROUPS
and simplify the definition.

Removed incorrect use of @internal and replaced with
@cond INTERNAL_HIDDEN.

Signed-off-by: Emil Gydesen <emil.gydesen@nordicsemi.no>