diff --git a/docs/src/admin/troubleshooting.html b/docs/src/admin/troubleshooting.html
index 13a08301..564cb17c 100644
--- a/docs/src/admin/troubleshooting.html
+++ b/docs/src/admin/troubleshooting.html
@@ -46,7 +46,7 @@ <h2>Known bugs</h2>
         <p>
             <a href="http://bugzilla.globus.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Nimbus&version=2.5&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&bug_severity=blocker&bug_severity=critical&bug_severity=major&bug_severity=normal&bug_severity=minor&bug_severity=trivial&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=">Known
             issues</a>: custom query to the bugzilla system, it lists out
-            all known issues with 2.5RC1 Nimbus components.
+            all known issues with 2.5 Nimbus components.
         </p>
     </li>
 </ul>
@@ -313,6 +313,38 @@ <h2>Service related</h2>
             environment variable.
         </p>
     </li>
+<br /><hr />
+    
+    <li>
+        <a name="python-build1"> </a>
+        <p>
+            Problem: The Cumulus build fails with an error about finding Python.h
+            _NAMELINK(python-build1)
+        </p>
+        <p>
+            You went the GCC route (see <a href="z2c/service-dependencies.html">the dependencies page</a>) and are seeing an error like:
+        </p>
+        <pre class="screen">src/crypto/crypto.c:12:20: error: Python.h</pre>
+        <p>
+            Solution: Install the Python development package (<tt class="literal">python-dev</tt> in Debian).
+        </p>
+    </li>
+<br /><hr />
+    
+    <li>
+        <a name="python-build2"> </a>
+        <p>
+            Problem: The Cumulus build fails with an error about Python.h
+            _NAMELINK(python-build1)
+        </p>
+        <p>
+            You went the GCC route (see <a href="z2c/service-dependencies.html">the dependencies page</a>) and are seeing an error like:
+        </p>
+        <pre class="screen">src/crypto/x509name.h:19: error: expected ')' before '*' token</pre>
+        <p>
+            Solution: Install the OpenSSL development package (<tt class="literal">libssl-dev</tt> in Debian).
+        </p>
+    </li>
 </ul>
 
 <br />
diff --git a/docs/src/admin/z2c/service-dependencies.html b/docs/src/admin/z2c/service-dependencies.html
index fd17497d..a21e8610 100644
--- a/docs/src/admin/z2c/service-dependencies.html
+++ b/docs/src/admin/z2c/service-dependencies.html
@@ -50,6 +50,12 @@ <h3>GCC</h3>
     <tt class="literal">Twisted 10.0.0</tt>.
 </p>
 
+<p>
+    When going the GCC route you would also need the Python development 
+    package (<tt class="literal">python-dev</tt> in Debian) and the OpenSSL
+    development package (<tt class="literal">libssl-dev</tt> in Debian).
+</p>
+
         
 <h3>Apache Ant 1.6.2 or later</h3>
 <p>