diff --git a/core/c/c.odin b/core/c/c.odin
index 73727d8d5..907b2f80f 100644
--- a/core/c/c.odin
+++ b/core/c/c.odin
@@ -1,3 +1,4 @@
+// package c just defines the basic types used by C programs
 package c
 
 import builtin "base:builtin"
diff --git a/core/c/libc/doc.odin b/core/c/libc/doc.odin
new file mode 100644
index 000000000..883a3dda5
--- /dev/null
+++ b/core/c/libc/doc.odin
@@ -0,0 +1,2 @@
+// package libc declares the commonly used things in "libc" (C standard library)
+package libc