Nits

Author: ernestognw

contracts/utils/Panic.sol

@@ -5,6 +5,18 @@ pragma solidity ^0.8.20;
 /**
  * @dev Helper library for emitting standardized panic codes.
  *
+ * ```solidity
+ * contract Example {
+ *      using Panic for uint256;
+ *
+ *      // Use any of the declared internal constants
+ *      function foo() { Panic.GENERIC.panic(); }
+ *
+ *      // Alternatively
+ *      function foo() { Panic.panic(Panic.GENERIC); }
+ * }
+ * ```
+ *
  * Follows the list from libsolutil: https://github.com/ethereum/solidity/blob/v0.8.24/libsolutil/ErrorCodes.h
  */
 // slither-disable-next-line unused-state
@@ -30,6 +42,8 @@ library Panic {
     /// @dev calling invalid internal function
     uint256 internal constant INVALID_INTERNAL_FUNCTION = 0x51;
 
+    /// @dev Reverts with a panic code. Recommended to use with
+    /// the internal constants with predefined codes.
     function panic(uint256 code) internal pure {
         /// @solidity memory-safe-assembly
         assembly {

contracts/utils/math/Math.sol

@@ -331,6 +331,8 @@ library Math {
             mstore(add(ptr, 0x80), e)
             mstore(add(ptr, 0xa0), m)
 
+            // Given the result < m, it's guaranteed to fit in 32 bytes,
+            // so we can use the memory scratch space located at offset 0.
             success := staticcall(gas(), 0x05, ptr, 0xc0, 0x00, 0x20)
             result := mload(0x00)
         }