diff --git a/docs/drivers/zink.rst b/docs/drivers/zink.rst
index 6efa63e2e1d..db008fcf813 100644
--- a/docs/drivers/zink.rst
+++ b/docs/drivers/zink.rst
@@ -332,6 +332,16 @@ be enabled by setting the environment variable :envvar:`VK_INSTANCE_LAYERS` to
 "VK_LAYER_KHRONOS_validation". You can read more about the Validation Layers
 in the link above.
 
+Apple macOS and MoltenVK
+------------------------
+
+Zink on macOS is experimental with very limited capabilities.
+The Vulkan SDK (1.3.250 or newer) is required to build Zink.
+Set the build option ``-Dmoltenvk-dir=<directory>`` to point at your Vulkan SDK install or MoltenVK build.
+Add Zink to the Gallium drivers build option ``-Dgallium-drivers=zink``.
+If installed using ``brew``, you can set ``-D moltenvk-dir=$(brew --prefix molten-vk)``.
+
+
 IRC
 ---
 
diff --git a/docs/macos.rst b/docs/macos.rst
index c74ee394aa5..f717185eec5 100644
--- a/docs/macos.rst
+++ b/docs/macos.rst
@@ -20,5 +20,6 @@ hardware-accelerated system OpenGL framework, to provide hardware acceleration
 to X11 applications on macOS running via XQuartz.
 
 Mesa's software rasterizers also work on macOS. To build, set the build options
-``-Dosmesa=true -Dglx=xlib`` and select an appropriate Gallium software
-rasterizer.
+``-Dosmesa=true -Dglx=xlib``.
+
+Mesa's Gallium drivers can be used on macOS by using the ``-Dgallium-drivers=<drivers>`` build option. Do not use with the previous software rasterizers options, instead add `swrast` to the ``<drivers>`` list. Only software renderers and drivers that forward to other APIs can work, any linux hardware drivers will not work. For details on each driver's macOS support see their specific documentation.