Guide users to the YAML config from the build detail page

readthedocs/builds/models.py

@@ -16,6 +16,7 @@
 from jsonfield import JSONField
 from taggit.managers import TaggableManager
 
+from readthedocs.config import LATEST_CONFIGURATION_VERSION
 from readthedocs.core.utils import broadcast
 from readthedocs.projects.constants import (
     BITBUCKET_URL,
@@ -640,6 +641,9 @@ def is_stale(self):
         mins_ago = timezone.now() - datetime.timedelta(minutes=5)
         return self.state == BUILD_STATE_TRIGGERED and self.date < mins_ago
 
+    def using_latest_config(self):
+        return int(self.config.get('version', '1')) == LATEST_CONFIGURATION_VERSION
+
 
 class BuildCommandResultMixin:
 

readthedocs/config/config.py

@@ -48,6 +48,7 @@
     'InvalidConfig',
     'PIP',
     'SETUPTOOLS',
+    'LATEST_CONFIGURATION_VERSION',
 )
 
 ALL = 'all'
@@ -78,6 +79,8 @@
 )
 DOCKER_IMAGE_SETTINGS = getattr(settings, 'DOCKER_IMAGE_SETTINGS', {})
 
+LATEST_CONFIGURATION_VERSION = 2
+
 
 class ConfigError(Exception):
 

readthedocs/rtd_tests/tests/test_builds.py

@@ -562,3 +562,21 @@ def test_build_is_stale(self):
         self.assertFalse(build_one.is_stale)
         self.assertTrue(build_two.is_stale)
         self.assertFalse(build_three.is_stale)
+
+    def test_using_latest_config(self):
+        now = timezone.now()
+
+        build = get(
+            Build,
+            project=self.project,
+            version=self.version,
+            date=now - datetime.timedelta(minutes=8),
+            state='finished',
+        )
+
+        self.assertFalse(build.using_latest_config())
+
+        build.config = {'version': 2}
+        build.save()
+
+        self.assertTrue(build.using_latest_config())

readthedocs/templates/builds/build_detail.html

@@ -135,6 +135,18 @@
           </p>
         </div>
       {% endif %}
+      {% if build.finished and not build.using_latest_config %}
+        <div class="build-ideas">
+          <p>
+            {% blocktrans trimmed with config_file_link="https://docs.readthedocs.io/page/config-file/v2.html" %}
+              <strong>Configure your documentation builds!</strong>
+              Adding a <a href="{{ config_file_link }}">.readthedocs.yml</a> file to your project
+              is the recommended way to configure your documentation builds.
+              You can declare dependencies, set up submodules, build for different output formats, and many other great features.
+            {% endblocktrans %}
+          </p>
+        </div>
+      {% endif %}
     {% endif %}
 
     {% if build.output %}