Suggest wiping your environment to folks with bad build outcomes.

readthedocs/builds/static/builds/css/detail.css

@@ -35,6 +35,10 @@ div.build-detail div.build-state > span.build-state-successful {
     background: #5a5;
 }
 
+div.build-detail div.build-ideas {
+    padding: .5em;
+}
+
 ul.build-meta {
     display: block;
     width: 40%;

readthedocs/core/views/__init__.py

@@ -98,7 +98,7 @@ def wipe_version(request, project_slug, version_slug):
         for del_dir in del_dirs:
             broadcast(type='build', task=remove_dir, args=[del_dir])
         return redirect('project_version_list', project_slug)
-    return render_to_response('wipe_version.html',
+    return render_to_response('wipe_version.html', {'version': version, 'project': version.project},
                               context_instance=RequestContext(request))
 
 

readthedocs/templates/builds/build_detail.html

@@ -92,6 +92,29 @@
       </span>
     </div>
 
+    <div class="build-ideas">
+    {% if not build.success and build.commands.count < 4 %}
+      <p>
+
+        {% url 'wipe_version' build.version.project.slug build.version.slug as wipe_url %}
+        {% blocktrans %}
+        Having trouble with your build environment?
+        Try <a href="{{ wipe_url }}">reseting it</a>.
+        {% endblocktrans %}
+      </p>
+    {% endif %}
+
+    {% if not build.success and "setup.py install" in build.commands.last.output %}
+      <p>
+        {% url 'projects_advanced' build.version.project.slug as advanced_url %}
+        {% blocktrans %}
+        Don't want <pre>setup.py install</pre> called?
+        Change the <strong>Install Project</strong> setting in your <a href="{{ advanced_url }}">advanced settings</a>.
+        {% endblocktrans %}
+      </p>
+    {% endif %}
+    </div>
+
     {% if build.output %}
       {# If we have build output, this is an old build #}
       <p>

readthedocs/templates/wipe_version.html

@@ -1,16 +1,31 @@
 {% extends "base.html" %}
 
+{% block project_editing %}
+  {% with versions_active="active" %}
+    {% include "core/project_bar.html" %}
+  {% endwith %}
+{% endblock %}
+
+
 {% block title %}Wipe the build directories for a version {% endblock %}
 
 {% block content %}
 
+{% blocktrans with slug=version.slug %}
+    <h3>Remove build environment for <em>{{ slug }}</em> version.</h3>
+{% endblocktrans %}
+
 {% if deleted %}
-Your project environment has been wiped.<br><br>
+    {% blocktrans %}
+        Your project environment has been wiped.<br><br>
+    {% endblocktrans %}
 {% else %}
-Having trouble getting your documentation build to complete?  By clicking on the button below you'll clean out your build checkouts and environment, but not your generated documentation.
+    {% blocktrans %}
+        Having trouble getting your documentation build to complete?  By clicking on the button below you'll clean out your build checkouts and environment, but not your generated documentation.
+    {% endblocktrans %}
 
 <form method="post" action="#">
-  <input type="submit" value="Wipe version">
+  <input type="submit" value="Wipe {{ version.slug }}">
 </form>
 {% endif %}