Index: documentation/content/en/books/handbook/x11/_index.adoc
===================================================================
--- documentation/content/en/books/handbook/x11/_index.adoc
+++ documentation/content/en/books/handbook/x11/_index.adoc
@@ -205,7 +205,25 @@
 [[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.
+As such, 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, or PORTS_MODULES `makeoptions` in the kernel config file.
+Alternatively, if you run GENERIC, you can just build the [.filename]#graphics/drm-kmod# port.
+
+[example]
+====
+[.filename]#/usr/src/sys/ARCH/conf/CUSTOM#
+
+[.programlisting]
+....
+include		GENERIC
+ident		CUSTOM
+makeoptions	PORTS_MODULES="graphics/drm-kmod"
+....
+There are more specific ports than `drm-kmod`; however that is a metaport that brings in the proper port for your version.
+====
+
 
 [[x-config-video-cards-ports]]
 Intel KMS driver, Radeon KMS driver, AMD KMS driver::
@@ -245,6 +263,22 @@
 +
 For reference, see https://en.wikipedia.org/wiki/List_of_Nvidia_graphics_processing_units[].
 
+Since video drivers use private kernel interfaces, it is strongly recommended that this driver be kept up to date using PORTS_MODULES mechanism.
+Alternatively, if you run GENERIC, you can just build the [.filename]#graphics/nvidia-driver-xxx# port.
+Fill in the `xxx` in the following kernel config file with the appropriate driver for your card.
+
+[example]
+====
+[.filename]#/usr/src/sys/ARCH/conf/CUSTOM#
+
+[.programlisting]
+....
+include		GENERIC
+ident		CUSTOM
+makeoptions	PORTS_MODULES="graphics/nvidia-driver-xxx"
+....
+====
+
 [[x-config-video-cards-hybrid]]
 Hybrid Combination Graphics::
 Some notebook computers add additional graphics processing units to those built into the chipset or processor. _Optimus_ combines Intel(R) and NVIDIA hardware. _Switchable Graphics_ or _Hybrid Graphics_ are a combination of an Intel(R) or AMD(R) processor and an AMD(R) Radeon `GPU`.