Bluetooth: ISO: Fix and format iso.h documentation

Fixed a few bad or missing documentation parts of iso.h
Also formatted some parts to be consistent with not just
the file itself, but also with bluetooth.h

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