diff --git a/doc/code.html b/doc/code.html
index f22e6b4919e..92616a5a5aa 100644
--- a/doc/code.html
+++ b/doc/code.html
@@ -110,6 +110,10 @@ packages and commands. Most Go programmers keep <i>all</i> their Go source code
 and dependencies in a single workspace.
 </p>
 
+<p>
+Note that symbolic links should <b>not</b> be used to link files or directories into your workspace.
+</p>
+
 <p>
 Commands and libraries are built from different kinds of source packages.
 We will discuss the distinction <a href="#PackageNames">later</a>.