diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 8a428278ff..1331d1adfc 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -93,14 +93,15 @@
         <glossentry id='var-B'><glossterm>B</glossterm>
             <glossdef>
                 <para>
-                    The directory in which the OpenEmbedded build system places
-                    generated objects during a recipe's build process.
+                    The <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink>.
+                    The OpenEmbedded build system places generated objects into the build directory
+                    during a recipe's build process.
                     By default, this directory is the same as the <link linkend='var-S'><filename>S</filename></link>
                     directory:
                     <literallayout class='monospaced'>
      B = ${WORKDIR}/${BPN}-{PV}/
                     </literallayout>
-                    You can separate the source directory (<filename>S</filename>) and the directory pointed to 
+                    You can separate the (<filename>S</filename>) directory and the directory pointed to 
                     by the <filename>B</filename> variable.
                     Most autotools-based recipes support separating these directories.
                     The build system defaults to using separate directories for <filename>gcc</filename>