[sw] Update source documentation

Fixes mostly spelling errors and outdated parameters.
Based on the warnings generated by Doxygen.

Signed-off-by: Tobias Wölfel <tobias.woelfel@mailbox.org>
diff --git a/sw/device/lib/dif/dif_otp_ctrl.h b/sw/device/lib/dif/dif_otp_ctrl.h
index d59d48d..890b5fa 100644
--- a/sw/device/lib/dif/dif_otp_ctrl.h
+++ b/sw/device/lib/dif/dif_otp_ctrl.h
@@ -656,7 +656,7 @@
  * Gets the current status of the OTP controller.
  *
  * @param otp An OTP handle.
- * @param[out] stauts Out-param for the controller's status.
+ * @param[out] status Out-param for the controller's status.
  * @return The result of the operation.
  */
 DIF_WARN_UNUSED_RESULT
@@ -835,7 +835,7 @@
  * addition, `address + len` must also be in-range and must not overflow.
  *
  * @param otp An OTP handle.
- * @param partition The partition to read from.
+ * @param address The address to read from.
  * @param[out] buf A buffer of words to write read values to.
  * @param len The number of words to read.
  * @return The result of the operation.