diff --git a/source/base.c b/source/base.c
index 95873fc..813da85 100644
--- a/source/base.c
+++ b/source/base.c
@@ -1,3 +1,7 @@
+// bit-specific integer types
+// @note(judah): unlike the intX_t types, these will not automagically promote
+// so explicit casting is required (especially in format strings).
+
 typedef unsigned _BitInt(1) bool1;
 typedef unsigned _BitInt(2) bool2;
 typedef unsigned _BitInt(4) bool4;
@@ -37,7 +41,7 @@ typedef double f64;
    typedef s64 sword;
 #endif
 
-static_assert(sizeof(uaddr) == sizeof(void*), "uaddr was not equal to a pointer");
+static_assert(sizeof(uaddr) == sizeof(void*), "sizeof(uaddr) != sizeof(void*)");
 
 #define auto __auto_type