[sensor-api] Tidy spec & fix docs.