From 88fa8229d3420a1d40e4e16263c8ee0bc5cc4a87 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Timo=20Westk=C3=A4mper?= <timo.westkamper@gmail.com>
Date: Sun, 12 Oct 2014 19:47:44 +0300
Subject: [PATCH] Improve docs

---
 .../src/main/docbook/en-US/content/tutorials/sql.xml          | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/querydsl-docs/src/main/docbook/en-US/content/tutorials/sql.xml b/querydsl-docs/src/main/docbook/en-US/content/tutorials/sql.xml
index 9335a259f..28a4aa6fb 100644
--- a/querydsl-docs/src/main/docbook/en-US/content/tutorials/sql.xml
+++ b/querydsl-docs/src/main/docbook/en-US/content/tutorials/sql.xml
@@ -748,6 +748,10 @@ query.with(employee, employee.id, employee.name)
      .from(...)
 ]]></programlisting>
 
+    <para>If the columns of the common table expression are a subset of an existing table or view
+    it is advisable to use a generated path type for it, e.g. QEmployee in this case, but if the
+    columns don't fit any existing table PathBuilder can be used instead.</para>
+
   </sect2>
   
   <sect2>