diff --git a/documentation/content/en/books/handbook/x11/_index.adoc b/documentation/content/en/books/handbook/x11/_index.adoc
--- a/documentation/content/en/books/handbook/x11/_index.adoc
+++ b/documentation/content/en/books/handbook/x11/_index.adoc
@@ -205,7 +205,28 @@
 [[x-config-video-cards]]
 === Video Cards
 
-Because of changes made in recent versions of FreeBSD, it is now possible to use graphics drivers provided by the Ports framework or as packages. As such, users can use one of the following drivers available from package:graphics/drm-kmod[].
+The Ports framework provides the drm graphics drivers necessary for X11 operation on recent hardware.
+Users can use one of the following drivers available from package:graphics/drm-kmod[].
+These drivers use interfaces in the kernel that are normally private.
+As such, it is strongly recommended that the drivers be built via the ports system via the `PORTS_MODULES` variable.
+With `PORTS_MODULES`, every time you build the kernel, the corresponding port(s) containing kernel modules are re-built against the updated sources.
+This ensures the kernel module stays in-sync with the kernel itself.
+The kernel and ports trees should be updated together for maximum compatibility.
+You can add `PORTS_MODULES` to your [.filename]#/etc/make.conf# file to ensure all kernels you build rebuild this module.
+Advanced users can add it to their kernel config files with the `makeoptions` directive.
+If you run GENERIC and use freebsd-update, you can just build the [.filename]#graphics/drm-kmod# or [.filename]#x11/nvidia-driver# port after each `freebsd-update install` invocation.
+
+[example]
+====
+[.filename]#/etc/make.conf#
+
+[.programlisting]
+....
+SYSDIR=path/to/src/sys
+PORTS_MODULES=graphics/drm-kmod x11/nvidia-driver
+....
+This will rebuild everything, but can select one or the other depending on which GPU / graphics card you have.
+====
 
 [[x-config-video-cards-ports]]
 Intel KMS driver, Radeon KMS driver, AMD KMS driver::
@@ -244,6 +265,16 @@
 Several NVIDIA drivers are available in the [.filename]#x11# category of the Ports Collection. Install the driver that matches the video card.
 +
 For reference, see https://en.wikipedia.org/wiki/List_of_Nvidia_graphics_processing_units[].
++
+Kernel support for NVIDIA cards is found in either the [.filename]#x11/nvidia-driver# port or the [.filename]#x11/nvidia-driver-xxx# port.
+Modern cards use the former.
+Legacy cards use the -xxx ports, where xxx is one of 304, 340 or 390 indicating the version of the driver.
+For those, fill in the `-xxx` using the http://download.nvidia.com/XFree86/FreeBSD-x86_64/465.19.01/README/[ Supported NvIDIA GPU Products ] page.
+This page lists the devices supported by different versions of the driver.
+Legacy drivers run on both i386 and amd64.
+The current driver only supports amd64.
+Read http://download.nvidia.com/XFree86/FreeBSD-x86_64/465.19.01/README/[installation and configuration of NVIDIA driver] for details.
+While we recommend this driver be rebuilt with each kernel rebuild for maximum safety, it uses almost no private kernel interfaces and is usually safe across kernel updates.
 
 [[x-config-video-cards-hybrid]]
 Hybrid Combination Graphics::