diff --git a/examples/all/all_vendor.odin b/examples/all/all_vendor.odin
index f94e092af..9aa109e5b 100644
--- a/examples/all/all_vendor.odin
+++ b/examples/all/all_vendor.odin
@@ -1,7 +1,6 @@
 //+build windows
 package all
 
-
 import botan     "vendor:botan"
 import ENet      "vendor:ENet"
 import gl        "vendor:OpenGL"
@@ -25,6 +24,15 @@ import stb_vorbis    "vendor:stb/vorbis"
 
 import vk "vendor:vulkan"
 
+import D3D11 "vendor:directx/d3d11"
+import D3D12 "vendor:directx/d3d12"
+import DXGI  "vendor:directx/dxgi"
+
+// note these are technicaly darwin only but they are added to aid with documentation generation
+import NS  "vendor:darwin/Foundation"
+import MTL "vendor:darwin/Metal"
+import CA  "vendor:darwin/QuartzCore"
+
 
 _ :: botan
 _ :: ENet
@@ -44,4 +52,10 @@ _ :: stbi
 _ :: stbrp
 _ :: stbtt
 _ :: stb_vorbis
-_ :: vk
\ No newline at end of file
+_ :: vk
+_ :: D3D11
+_ :: D3D12
+_ :: DXGI
+_ :: NS
+_ :: MTL
+_ :: CA
\ No newline at end of file
diff --git a/src/check_builtin.cpp b/src/check_builtin.cpp
index 1535f6644..fb7a6efce 100644
--- a/src/check_builtin.cpp
+++ b/src/check_builtin.cpp
@@ -248,8 +248,9 @@ bool check_builtin_objc_procedure(CheckerContext *c, Operand *operand, Ast *call
 	String builtin_name = builtin_procs[id].name;
 
 	if (build_context.metrics.os != TargetOs_darwin) {
-		error(call, "'%.*s' only works on darwin", LIT(builtin_name));
-		return false;
+		if (!build_context.generate_docs) { // allow on doc generation (e.g. Metal stuff)
+			error(call, "'%.*s' only works on darwin", LIT(builtin_name));
+		}
 	}
 
 
diff --git a/vendor/darwin/Foundation/NSArray.odin b/vendor/darwin/Foundation/NSArray.odin
index 4392c2791..d6021838b 100644
--- a/vendor/darwin/Foundation/NSArray.odin
+++ b/vendor/darwin/Foundation/NSArray.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 import "core:intrinsics"
diff --git a/vendor/darwin/Foundation/NSAutoreleasePool.odin b/vendor/darwin/Foundation/NSAutoreleasePool.odin
index f0157107e..a388a7146 100644
--- a/vendor/darwin/Foundation/NSAutoreleasePool.odin
+++ b/vendor/darwin/Foundation/NSAutoreleasePool.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 @(objc_class="NSAutoreleasePool")
diff --git a/vendor/darwin/Foundation/NSBundle.odin b/vendor/darwin/Foundation/NSBundle.odin
index 2e9d0df83..5e136378b 100644
--- a/vendor/darwin/Foundation/NSBundle.odin
+++ b/vendor/darwin/Foundation/NSBundle.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 @(objc_class="NSBundle")
diff --git a/vendor/darwin/Foundation/NSData.odin b/vendor/darwin/Foundation/NSData.odin
index b5367af07..3c6369e86 100644
--- a/vendor/darwin/Foundation/NSData.odin
+++ b/vendor/darwin/Foundation/NSData.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 @(objc_class="NSData")
diff --git a/vendor/darwin/Foundation/NSDate.odin b/vendor/darwin/Foundation/NSDate.odin
index 5aef42c13..e30cb07d0 100644
--- a/vendor/darwin/Foundation/NSDate.odin
+++ b/vendor/darwin/Foundation/NSDate.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 @(objc_class="NSDate")
diff --git a/vendor/darwin/Foundation/NSDictionary.odin b/vendor/darwin/Foundation/NSDictionary.odin
index 54f2e3446..3832c05f1 100644
--- a/vendor/darwin/Foundation/NSDictionary.odin
+++ b/vendor/darwin/Foundation/NSDictionary.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 @(objc_class="NSDictionary")
diff --git a/vendor/darwin/Foundation/NSEnumerator.odin b/vendor/darwin/Foundation/NSEnumerator.odin
index 0f1bdc482..1c7ddeed2 100644
--- a/vendor/darwin/Foundation/NSEnumerator.odin
+++ b/vendor/darwin/Foundation/NSEnumerator.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 import "core:c"
diff --git a/vendor/darwin/Foundation/NSError.odin b/vendor/darwin/Foundation/NSError.odin
index 868e6acc6..23e6eaba7 100644
--- a/vendor/darwin/Foundation/NSError.odin
+++ b/vendor/darwin/Foundation/NSError.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 foreign import "system:Foundation.framework"
diff --git a/vendor/darwin/Foundation/NSLock.odin b/vendor/darwin/Foundation/NSLock.odin
index 48c3a0e23..c48b5dbad 100644
--- a/vendor/darwin/Foundation/NSLock.odin
+++ b/vendor/darwin/Foundation/NSLock.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 Locking :: struct($T: typeid) {using _: Object}
diff --git a/vendor/darwin/Foundation/NSNotification.odin b/vendor/darwin/Foundation/NSNotification.odin
index da9874bbc..ec8dddab7 100644
--- a/vendor/darwin/Foundation/NSNotification.odin
+++ b/vendor/darwin/Foundation/NSNotification.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 @(objc_class="NSNotification")
diff --git a/vendor/darwin/Foundation/NSNumber.odin b/vendor/darwin/Foundation/NSNumber.odin
index eb28b7099..b0cfbfb40 100644
--- a/vendor/darwin/Foundation/NSNumber.odin
+++ b/vendor/darwin/Foundation/NSNumber.odin
@@ -1,10 +1,11 @@
-//+build darwin
 package objc_Foundation
 
 import "core:c"
 
-#assert(size_of(c.long)  == size_of(int))
-#assert(size_of(c.ulong) == size_of(uint))
+when ODIN_OS == .Darwin {
+	#assert(size_of(c.long)  == size_of(int))
+	#assert(size_of(c.ulong) == size_of(uint))
+}
 
 @(objc_class="NSValue")
 Value :: struct{using _: Copying(Value)}
diff --git a/vendor/darwin/Foundation/NSObject.odin b/vendor/darwin/Foundation/NSObject.odin
index 33ef26a23..1ce17f2f5 100644
--- a/vendor/darwin/Foundation/NSObject.odin
+++ b/vendor/darwin/Foundation/NSObject.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 import "core:intrinsics"
diff --git a/vendor/darwin/Foundation/NSRange.odin b/vendor/darwin/Foundation/NSRange.odin
index 48bce5f38..74ce595a3 100644
--- a/vendor/darwin/Foundation/NSRange.odin
+++ b/vendor/darwin/Foundation/NSRange.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 Range :: struct {
diff --git a/vendor/darwin/Foundation/NSString.odin b/vendor/darwin/Foundation/NSString.odin
index 5807db2db..45b5df37b 100644
--- a/vendor/darwin/Foundation/NSString.odin
+++ b/vendor/darwin/Foundation/NSString.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 foreign import "system:Foundation.framework"
diff --git a/vendor/darwin/Foundation/NSTypes.odin b/vendor/darwin/Foundation/NSTypes.odin
index 2cb9000e9..47f75630f 100644
--- a/vendor/darwin/Foundation/NSTypes.odin
+++ b/vendor/darwin/Foundation/NSTypes.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 import "core:intrinsics"
diff --git a/vendor/darwin/Foundation/NSURL.odin b/vendor/darwin/Foundation/NSURL.odin
index 995117a65..72e5fc906 100644
--- a/vendor/darwin/Foundation/NSURL.odin
+++ b/vendor/darwin/Foundation/NSURL.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 @(objc_class="NSURL")
diff --git a/vendor/darwin/Foundation/NSWindow.odin b/vendor/darwin/Foundation/NSWindow.odin
index 654009bda..dec5a160c 100644
--- a/vendor/darwin/Foundation/NSWindow.odin
+++ b/vendor/darwin/Foundation/NSWindow.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Foundation
 
 import NS "vendor:darwin/Foundation"
diff --git a/vendor/darwin/Metal/MetalClasses.odin b/vendor/darwin/Metal/MetalClasses.odin
index 4bc43002d..9713bba02 100644
--- a/vendor/darwin/Metal/MetalClasses.odin
+++ b/vendor/darwin/Metal/MetalClasses.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Metal
 
 import NS "vendor:darwin/Foundation"
diff --git a/vendor/darwin/Metal/MetalEnums.odin b/vendor/darwin/Metal/MetalEnums.odin
index 5cfa33558..2a6ab749a 100644
--- a/vendor/darwin/Metal/MetalEnums.odin
+++ b/vendor/darwin/Metal/MetalEnums.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Metal
 
 import NS "vendor:darwin/Foundation"
diff --git a/vendor/darwin/Metal/MetalErrors.odin b/vendor/darwin/Metal/MetalErrors.odin
index da37b59ff..f214466e5 100644
--- a/vendor/darwin/Metal/MetalErrors.odin
+++ b/vendor/darwin/Metal/MetalErrors.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Metal
 
 import NS "vendor:darwin/Foundation"
diff --git a/vendor/darwin/Metal/MetalProcedures.odin b/vendor/darwin/Metal/MetalProcedures.odin
index 24ec2f8dd..b76c7f541 100644
--- a/vendor/darwin/Metal/MetalProcedures.odin
+++ b/vendor/darwin/Metal/MetalProcedures.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Metal
 
 import NS "vendor:darwin/Foundation"
diff --git a/vendor/darwin/Metal/MetalTypes.odin b/vendor/darwin/Metal/MetalTypes.odin
index 1aabfa83e..673769c09 100644
--- a/vendor/darwin/Metal/MetalTypes.odin
+++ b/vendor/darwin/Metal/MetalTypes.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_Metal
 
 import NS "vendor:darwin/Foundation"
diff --git a/vendor/darwin/QuartzCore/QuartzCore.odin b/vendor/darwin/QuartzCore/QuartzCore.odin
index 7bcf216f1..fb6e04b07 100644
--- a/vendor/darwin/QuartzCore/QuartzCore.odin
+++ b/vendor/darwin/QuartzCore/QuartzCore.odin
@@ -1,4 +1,3 @@
-//+build darwin
 package objc_QuartzCore
 
 import NS "vendor:darwin/Foundation"