diff --git a/wgpu/src/lib.rs b/wgpu/src/lib.rs
index 69cb5ecaed..15408d8a7d 100644
--- a/wgpu/src/lib.rs
+++ b/wgpu/src/lib.rs
@@ -788,6 +788,8 @@ impl Drop for ShaderModule {
 #[non_exhaustive]
 pub enum ShaderSource<'a> {
     /// SPIR-V module represented as a slice of words.
+    ///
+    /// See also: [`util::make_spirv`], [`include_spirv`]
     #[cfg(feature = "spirv")]
     #[cfg_attr(docsrs, doc(cfg(feature = "spirv")))]
     SpirV(Cow<'a, [u32]>),
diff --git a/wgpu/src/macros.rs b/wgpu/src/macros.rs
index e86ab69ce7..fc3560e01c 100644
--- a/wgpu/src/macros.rs
+++ b/wgpu/src/macros.rs
@@ -44,6 +44,8 @@ fn test_vertex_attr_array() {
 /// Macro to load a SPIR-V module statically.
 ///
 /// It ensures the word alignment as well as the magic number.
+///
+/// Return type: [`crate::ShaderModuleDescriptor`]
 #[macro_export]
 #[cfg(feature = "spirv")]
 macro_rules! include_spirv {