diff --git a/glfw/build.zig b/glfw/build.zig
index 268b0f42..a0ca24b0 100644
--- a/glfw/build.zig
+++ b/glfw/build.zig
@@ -20,19 +20,19 @@ pub const LinuxWindowManager = enum {
 };
 
 pub const Options = struct {
-    // Not supported on macOS.
+    /// Not supported on macOS.
     vulkan: bool = true,
 
-    // Only respected on macOS.
+    /// Only respected on macOS.
     metal: bool = true,
 
-    // Deprecated on macOS.
+    /// Deprecated on macOS.
     opengl: bool = false,
 
-    // Not supported on macOS.
+    /// Not supported on macOS.
     gles: bool = false,
 
-    // Only respected on Linux.
+    /// Only respected on Linux.
     linux_window_manager: LinuxWindowManager = .X11,
 };
 
@@ -216,7 +216,7 @@ fn includeSdkMacOS(b: *Builder, step: *std.build.LibExeObjStep) void {
     b.sysroot = sdk_sysroot; // TODO(slimsag): leaks, b.sysroot doesn't get free'd by builder?
 }
 
-// Caller owns returned memory.
+/// Caller owns returned memory.
 fn getSdkRoot(allocator: *std.mem.Allocator, comptime name: []const u8) ![]const u8 {
     const app_data_dir = try std.fs.getAppDataDir(allocator, "mach");
     var sdk_root_dir = try std.fs.path.join(allocator, &.{ app_data_dir, name });
diff --git a/glfw/src/action.zig b/glfw/src/action.zig
index 5fafe8a2..80af85a3 100644
--- a/glfw/src/action.zig
+++ b/glfw/src/action.zig
@@ -2,11 +2,11 @@
 
 const c = @cImport(@cInclude("GLFW/glfw3.h"));
 
-// The key or mouse button was released.
+/// The key or mouse button was released.
 pub const release = C.GLFW_RELEASE;
 
-// The key or mouse button was pressed.
+/// The key or mouse button was pressed.
 pub const press = C.GLFW_RELEASE;
 
-// The key was held down until it repeated.
+/// The key was held down until it repeated.
 pub const repeat = C.GLFW_REPEAT;
diff --git a/glfw/src/version.zig b/glfw/src/version.zig
index 3e6c998b..61e9eb69 100644
--- a/glfw/src/version.zig
+++ b/glfw/src/version.zig
@@ -2,17 +2,17 @@
 
 const c = @cImport(@cInclude("GLFW/glfw3.h"));
 
-// The major version number of the GLFW library.
-//
-// This is incremented when the API is changed in non-compatible ways.
+/// The major version number of the GLFW library.
+///
+/// This is incremented when the API is changed in non-compatible ways.
 pub const major = c.GLFW_VERSION_MAJOR;
 
-// The minor version number of the GLFW library.
-//
-// This is incremented when features are added to the API but it remains backward-compatible.
+/// The minor version number of the GLFW library.
+///
+/// This is incremented when features are added to the API but it remains backward-compatible.
 pub const minor = c.GLFW_VERSION_MINOR;
 
-// The revision number of the GLFW library.
-//
-// This is incremented when a bug fix release is made that does not contain any API changes.
+/// The revision number of the GLFW library.
+///
+/// This is incremented when a bug fix release is made that does not contain any API changes.
 pub const revision = c.GLFW_VERSION_REVISION;