gscan 4.29.1 → 4.29.2

package/app/tpl/error.hbs

@@ -7,6 +7,6 @@
         <p>{{context}}</p>
         <p>{{details}}</p>
         <p>{{stack}}</p>
-        <p>Please visit our <a href="https://forum.ghost.org">forum</a> and let us know!</p>
+        <p>Please visit our <a href="https://forum.ghost.org/">forum</a> and let us know!</p>
     </section>
 </div>

package/app/tpl/layouts/default.hbs

@@ -57,8 +57,8 @@
 
         </div>
         <div class="gh-navbar-right">
-            <a class="gh-navbar-item" href="https://ghost.org/docs/api/handlebars-themes/" target="blank" rel="noopener">Theme Docs</a>
-            <a class="gh-navbar-btn gh-btn" href="https://ghost.org"><span>Ghost.org</span></a>
+            <a class="gh-navbar-item" href="https://ghost.org/docs/themes/" target="blank" rel="noopener">Theme Docs</a>
+            <a class="gh-navbar-btn gh-btn" href="https://ghost.org/"><span>Ghost.org</span></a>
         </div>
     </nav>
 </header>
@@ -99,8 +99,8 @@
     </nav>
     <div class="gh-mobilemenu">
         <a class="gh-navbar-item" href="https://gscan.ghost.org">GScan</a>
-        <a class="gh-navbar-item" href="https://ghost.org/docs/api/handlebars-themes/">Theme Docs</a>
-        <a class="gh-navbar-item" href="https://ghost.org">Ghost.org</a>
+        <a class="gh-navbar-item" href="https://ghost.org/docs/themes/">Theme Docs</a>
+        <a class="gh-navbar-item" href="https://ghost.org/">Ghost.org</a>
     </div>
 </header>
 
@@ -112,9 +112,9 @@
 
 <footer class="gh-foot">
     <div class="gh-foot-support inner">
-        <div class="gh-support-email" href="https://ghost.org/pricing">
+        <div class="gh-support-email" href="https://ghost.org/pricing/">
             <h4>Ready to upgrade to the best?</h4>
-            <p>Spend less time running your servers and more time running your site. <strong><a href="https://ghost.org/pricing">Ghost(Pro)</a></strong>
+            <p>Spend less time running your servers and more time running your site. <strong><a href="https://ghost.org/pricing/">Ghost(Pro)</a></strong>
                 has got you covered</p>
         </div>
         <div class="gh-support-slack">
@@ -125,7 +125,7 @@
     </div>
     <div class="gh-foot-content inner">
         <nav class="gh-foot-min-nav">
-            <a class="gh-foot-min-item gh-foot-min-logo" href="https://ghost.org">
+            <a class="gh-foot-min-item gh-foot-min-logo" href="https://ghost.org/">
                 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 294" preserveAspectRatio="xMidYMid meet" class="ghost-orb-logo-wh">
                     <title>Ghost Logo</title>
                     <style>
@@ -154,7 +154,7 @@
             <a class="gh-foot-min-item" href="https://twitter.com/ghost">@Ghost</a>
         </nav>
         <div class="gh-foot-min-back">
-            <a class="gh-foot-min-item" href="https://ghost.org">Back to Ghost</a>
+            <a class="gh-foot-min-item" href="https://ghost.org/">Back to Ghost</a>
         </div>
     </div>
 </footer>

package/bin/cli.js

@@ -221,7 +221,7 @@ function outputResults(theme, options) {
         _.each(theme.results.recommendation, rule => outputResult(rule, options));
     }
 
-    ui.log(`\nGet more help at ${chalk.cyan.underline('https://ghost.org/docs/api/handlebars-themes/')}`);
+    ui.log(`\nGet more help at ${chalk.cyan.underline('https://ghost.org/docs/themes/')}`);
     ui.log(`You can also check theme compatibility at ${chalk.cyan.underline('https://gscan.ghost.org/')}`);
 
     // The CLI feature is mainly used to run gscan programatically in tests within themes.

package/lib/specs/canary.js

@@ -23,7 +23,7 @@ let rules = {
         level: 'warning',
         rule: 'Remove <code>"engines.ghost-api"</code> from <code>package.json</code>.',
         details: oneLineTrim`The <code>"ghost-api"</code> version is no longer used and can be removed.<br>
-        Find more information about the <code>package.json</code> file <a href="${docsBaseUrl}packagejson/" target=_blank>here</a>.`
+        Find more information about the <code>package.json</code> file <a href="${docsBaseUrl}structure/#packagejson" target=_blank>here</a>.`
     },
     'GS090-NO-AUTHOR-HELPER-IN-POST-CONTEXT': {
         level: 'error',
@@ -414,7 +414,7 @@ let rules = {
         rule: 'Replace <code>{{post.author_id}}</code> code with <code>{{post.primary_author.id}}</code>',
         details: oneLineTrim`The <code>{{post.author_id}}</code> attribute in post context was removed<br>
         Instead of <code>{{post.author_id}}</code> you need to use <code>{{post.primary_author.id}}</code>.<br>
-        Find more information about the object attributes of <code>post</code> <a href="${docsBaseUrl}context/post/#post-object-attributes" target=_blank>here</a>.`,
+        Find more information about the object attributes of <code>post</code> <a href="${docsBaseUrl}contexts/post/#post-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?post\.author_id\s*?}}/g,
         helper: '{{post.author_id}}'
     },
@@ -447,7 +447,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{author.cover}}</code> you need to use
         <code>{{primary_author.cover_image}}</code> or <code>{{authors.[#].cover_image}}</code>.<br>
-        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?author\.cover\s*?}}/g,
         helper: '{{author.cover}}'
     },
@@ -458,7 +458,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{author.image}}</code>, you need to use
         <code>{{primary_author.profile_image}}</code> or <code>{{authors.[#].profile_image}}</code>.<br>
-        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?author\.image\s*?}}/g,
         helper: '{{author.image}}'
     },
@@ -469,7 +469,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{post.author.cover}}</code>, you need to use
         <code>{{post.primary_author.cover_image}}</code> or <code>{{post.authors.[#].cover_image}}</code>.<br>
-        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?post\.author\.cover\s*?}}/g,
         helper: '{{post.author.cover}}'
     },
@@ -526,7 +526,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{post.author.image}}</code>, you need to use
         <code>{{post.primary_author.profile_image}}</code> or <code>{{post.authors.[#].profile_image}}</code>.<br>
-        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?post\.author\.image\s*?}}/g,
         helper: '{{post.author.image}}'
     },
@@ -561,7 +561,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{#if author.cover}}</code>, you need to use
         <code>{{#if primary_author.cover_image}}</code> or <code>{{#if authors.[#].cover_image}}</code>.<br>
-        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?author\.cover\s*?}}/g,
         helper: '{{#if author.cover}}'
     },
@@ -572,7 +572,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{#if author.image}}</code>, you need to use
         <code>{{#if primary_author.profile_image}}</code> or <code>{{#if authors.[#].profile_image}}</code>.<br>
-        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?author\.image\s*?}}/g,
         helper: '{{#if author.image}}'
     },
@@ -583,7 +583,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{#if post.author.cover}}</code>, you need to use
         <code>{{#if post.primary_author.cover_image}}</code> or <code>{{#if post.authors.[#].cover_image}}</code>.<br>
-        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?post\.author\.cover\s*?}}/g,
         helper: '{{#if post.author.cover}}'
     },
@@ -594,7 +594,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{#if post.author.image}}</code>, you need to use
         <code>{{#if post.primary_author.profile_image}}</code> or <code>{{#if post.authors.[#].profile_image}}</code>.<br>
-        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        Find more information about the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?post\.author\.image\s*?}}/g,
         helper: '{{#if post.author.image}}'
     },

package/lib/specs/v1.js

@@ -4,7 +4,7 @@
  * This file contains details of the theme API spec, in a format that can be used by GScan
  */
 const oneLineTrim = require('common-tags/lib/oneLineTrim');
-const docsBaseUrl = `https://ghost.org/docs/api/handlebars-themes/`;
+const docsBaseUrl = `https://ghost.org/docs/themes/`;
 let knownHelpers, templates, rules, ruleNext; // eslint-disable-line no-unused-vars
 
 knownHelpers = [
@@ -100,7 +100,7 @@ rules = {
         Depending on the context of the <code>{{img_url}}</code> helper you would need to use e. g. <br><br><code>{{#post}}<br>&nbsp;&nbsp;&nbsp;&nbsp;{{img_url feature_image}}<br>{{/post}}</code><br><br>to render the feature image of the blog post.<br>
         <br><b>If you are using <code>{{if image}}</code></b>, then you have to replace it with e.g. <code>{{if feature_image}}.</code>
         <br><br>Find more information about the <code>{{img_url}}</code> helper <a href="${docsBaseUrl}helpers/img_url/" target=_blank>here</a> and
-        read more about Ghost's usage of contexts <a href="${docsBaseUrl}context/" target=_blank>here</a>.`,
+        read more about Ghost's usage of contexts <a href="${docsBaseUrl}contexts/" target=_blank>here</a>.`,
         regex: /{{\s*?image\b[\w\s='"]*?}}/g,
         helper: '{{image}}'
     },
@@ -110,7 +110,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>. To render the cover image in author context, you need to use<br><br>
         <code>{{#author}}<br>&nbsp;&nbsp;&nbsp;&nbsp;{{cover_image}}<br>{{/author}}</code><br><br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.<br>
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.<br>
         To render the cover image of your blog, just use <code>{{@site.cover_image}}</code>. See <a href="${docsBaseUrl}helpers/site/" target=_blank>here</a>.`,
         regex: /{{\s*?cover\s*?}}/g,
         helper: '{{cover}}'
@@ -121,7 +121,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>image</code> attribute in author context was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{author.image}}</code> you need to use <code>{{author.profile_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?author\.image\s*?}}/g,
         helper: '{{author.image}}'
     },
@@ -131,7 +131,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>image</code> attribute in post context was replaced with <code>feature_image</code>.<br>
         Instead of <code>{{post.image}}</code> you need to use <code>{{post.feature_image}}</code>.<br>
-        See the object attributes of <code>post</code> <a href="${docsBaseUrl}context/post/#post-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>post</code> <a href="${docsBaseUrl}contexts/post/#post-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?post\.image\s*?}}/g,
         helper: '{{post.image}}'
     },
@@ -151,7 +151,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{author.cover}}</code> you need to use <code>{{author.cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?author\.cover\s*?}}/g,
         helper: '{{author.cover}}'
     },
@@ -161,7 +161,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>image</code> attribute in tag context was replaced with <code>feature_image</code>.<br>
         Instead of <code>{{tag.image}}</code> you need to use <code>{{tag.feature_image}}</code>.<br>
-        See the object attributes of <code>tags</code> <a href="${docsBaseUrl}context/tag/#tag-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>tags</code> <a href="${docsBaseUrl}contexts/tag/#tag-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?tag\.image\s*?}}/g,
         helper: '{{tag.image}}'
     },
@@ -171,7 +171,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>image</code> attribute in author context was replaced with <code>feature_image</code>.<br>
         Instead of <code>{{post.author.image}}</code> you need to use <code>{{post.author.feature_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?post\.author\.image\s*?}}/g,
         helper: '{{post.author.image}}'
     },
@@ -181,7 +181,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>cover</code> attribute in author context was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{post.author.cover}}</code> you need to use <code>{{post.author.cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?post\.author\.cover\s*?}}/g,
         helper: '{{post.author.cover}}'
     },
@@ -191,7 +191,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>image</code> attribute in tag context was replaced with <code>feature_image</code>.<br>
         Instead of <code>{{post.tags.[#].image}}</code> you need to use <code>{{post.tags.[#].feature_image}}</code>.<br>
-        See the object attributes of <code>tags</code> <a href="${docsBaseUrl}context/tag/#tag-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>tags</code> <a href="${docsBaseUrl}contexts/tag/#tag-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?post\.tags\.\[[0-9]+\]\.image\s*?}}/g,
         helper: '{{post.tags.[#].image}}'
     },
@@ -201,7 +201,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>image</code> attribute in tag context was replaced with <code>feature_image</code>.<br>
         Instead of <code>{{tags.[#].image}}</code> you need to use <code>{{tags.[#].feature_image}}</code>.<br>
-        See the object attributes of <code>tags</code> <a href="${docsBaseUrl}context/tag/#tag-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>tags</code> <a href="${docsBaseUrl}contexts/tag/#tag-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?tags\.\[[0-9]+\]\.image\s*?}}/g,
         helper: '{{tags.[#].image}}'
     },
@@ -211,19 +211,19 @@ rules = {
         '{{#if profile_image}}</code>',
         fatal: true,
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>feature_image</code> and <code>profile_image</code>.<br>
-        Depending on the <a href="${docsBaseUrl}context/" target=_blank>context</a> you will need to replace it like this:<br><br>
+        Depending on the <a href="${docsBaseUrl}contexts/" target=_blank>context</a> you will need to replace it like this:<br><br>
         <code>{{#author}}<br>
         &nbsp;&nbsp;&nbsp;&nbsp;{{#if profile_image}}<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{{profile_image}}<br>&nbsp;&nbsp;&nbsp;&nbsp;{{/if}}<br>
         {{/author}}</code><br><br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.<br><br>
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.<br><br>
         <code>{{#post}}<br>
         &nbsp;&nbsp;&nbsp;&nbsp;{{#if feature_image}}<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{{feature_image}}<br>&nbsp;&nbsp;&nbsp;&nbsp;{{/if}}<br>
         {{/post}}</code><br><br>
-        See the object attributes of <code>post</code> <a href="${docsBaseUrl}context/post/#post-object-attributes" target=_blank>here</a>.<br><br>
+        See the object attributes of <code>post</code> <a href="${docsBaseUrl}contexts/post/#post-object-attributes" target=_blank>here</a>.<br><br>
         <code>{{#tag}}<br>
         &nbsp;&nbsp;&nbsp;&nbsp;{{#if feature_image}}<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{{feature_image}}<br>&nbsp;&nbsp;&nbsp;&nbsp;{{/if}}<br>
         {{/tag}}</code><br><br>
-        See the object attributes of <code>tags</code> <a href="${docsBaseUrl}context/tag/#tag-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>tags</code> <a href="${docsBaseUrl}contexts/tag/#tag-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?image\s*?}}/g,
         helper: '{{#if image}}'
     },
@@ -233,7 +233,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>. To check for the cover image in author context, you need to use<br><br>
         <code>{{#if cover_image}}<br>&nbsp;&nbsp;&nbsp;&nbsp;{{cover_image}}<br>{{/if}}</code><br><br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.<br>
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.<br>
         To check for the cover image of your blog, just use <code>{{#if @site.cover_image}}</code>. See <a href="${docsBaseUrl}helpers/site/" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?cover\s*?}}/g,
         helper: '{{#if cover}}'
@@ -254,7 +254,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{#if author.cover}}</code> you need to use <code>{{#if author.cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?author\.cover\s*?}}/g,
         helper: '{{#if author.cover}}'
     },
@@ -264,7 +264,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>image</code> attribute in author context was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{#if author.image}}</code> you need to use <code>{{#if author.profile_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?author\.image\s*?}}/g,
         helper: '{{#if author.image}}'
     },
@@ -274,7 +274,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{#if post.author.cover}}</code> you need to use <code>{{#if post.author.cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?post\.author\.cover\s*?}}/g,
         helper: '{{#if post.author.cover}}'
     },
@@ -284,7 +284,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>image</code> attribute in author context was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{#if post.author.image}}</code> you need to use <code>{{#if post.author.profile_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?post\.author\.image\s*?}}/g,
         helper: '{{#if post.author.image}}'
     },
@@ -294,7 +294,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>image</code> attribute in tag context was replaced with <code>feature_image</code>.<br>
         Instead of <code>{{#if tag.image}}</code> you need to use <code>{{#if tag.feature_image}}</code>.<br>
-        See the object attributes of <code>tags</code> <a href="${docsBaseUrl}context/tag/#tag-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>tags</code> <a href="${docsBaseUrl}contexts/tag/#tag-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?tag\.image\s*?}}/g,
         helper: '{{#if tag.image}}'
     },
@@ -304,7 +304,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>image</code> attribute in tag context was replaced with <code>feature_image</code>.<br>
         Instead of <code>{{#if post.tags.[#].image}}</code> you need to use <code>{{#if post.tags.[#].feature_image}}</code>.<br>
-        See the object attributes of <code>tags</code> <a href="${docsBaseUrl}context/tag/#tag-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>tags</code> <a href="${docsBaseUrl}contexts/tag/#tag-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?post\.tags\.\[[0-9]+\].image\s*?}}/g,
         helper: '{{#if posts.tags.[#].image}}'
     },
@@ -314,7 +314,7 @@ rules = {
         fatal: true,
         details: oneLineTrim`The <code>image</code> attribute in tag context was replaced with <code>feature_image</code>.<br>
         Instead of <code>{{#if tags.[#].image}}</code> you need to use <code>{{#if tags.[#].feature_image}}</code>.<br>
-        See the object attributes of <code>tags</code> <a href="${docsBaseUrl}context/tag/#tag-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>tags</code> <a href="${docsBaseUrl}contexts/tag/#tag-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?tags\.\[[0-9]+\].image\s*?}}/g,
         helper: '{{#if tags.[#].image}}'
     },
@@ -323,7 +323,7 @@ rules = {
         rule: 'Replace <code>{{@blog.posts_per_page}}</code> with <code>{{@config.posts_per_page}}</code>',
         details: oneLineTrim`The global <code>{{@blog.posts_per_page}}</code> property was replaced with <code>{{@config.posts_per_page}}</code>.<br>
         Read <a href="${docsBaseUrl}helpers/config/" target=_blank>here</a> about the attribute and
-        check <a href="${docsBaseUrl}packagejson/" target=_blank>here</a> where you can customise the posts per page setting, as this is now adjustable in your theme.`,
+        check <a href="${docsBaseUrl}structure/#packagejson" target=_blank>here</a> where you can customise the posts per page setting, as this is now adjustable in your theme.`,
         regex: /{{\s*?@blog\.posts_per_page\s*?}}/g,
         helper: '{{@blog.posts_per_page}}'
     },
@@ -339,7 +339,7 @@ rules = {
         level: 'error',
         rule: 'Replace <code>.archive-template</code> with the <code>.paged</code> CSS class',
         details: oneLineTrim`The <code>.archive-template</code> CSS class was replaced with the <code>.paged</code>. Please replace this in your stylesheet.<br>
-        See the <a href="${docsBaseUrl}context/" target=_blank>context table</a> to check which classes Ghost uses for each context.`,
+        See the <a href="${docsBaseUrl}contexts/" target=_blank>context table</a> to check which classes Ghost uses for each context.`,
         regex: /\.archive-template[\s{]/g,
         className: '.archive-template',
         css: true
@@ -348,7 +348,7 @@ rules = {
         level: 'error',
         rule: 'Replace <code>.page-template-slug</code> with the <code>.page-slug</code> css class',
         details: oneLineTrim`The <code>.page-template-slug</code> CSS class was replaced with the <code>.page-slug</code>. Please replace this in your stylesheet.<br>
-        See the <a href="${docsBaseUrl}context/" target=_blank>context table</a> to check which classes Ghost uses for each context.`,
+        See the <a href="${docsBaseUrl}contexts/" target=_blank>context table</a> to check which classes Ghost uses for each context.`,
         regex: /\.page-template-\w+[\s{]/g,
         className: '.page-template-slug',
         css: true
@@ -394,13 +394,13 @@ rules = {
         level: 'error',
         rule: '<code>package.json</code> file should be present',
         details: oneLineTrim`You should provide a <code>package.json</code> file for your theme.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> to see which properties are required and which are recommended.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> to see which properties are required and which are recommended.`
     },
     'GS010-PJ-PARSE': {
         level: 'error',
         rule: '<code>package.json</code> file can be parsed',
         details: oneLineTrim`Your <code>package.json</code> file couldn't be parsed. This is mostly caused by a missing or unnecessary <code>','</code> or the wrong usage of <code>'""'</code>.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.<br>
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.<br>
         A good reference for your <code>package.json</code> file is always the latest version of  <a href="https://github.com/TryGhost/Casper/blob/master/package.json" target=_blank>Casper</a>.`
     },
     'GS010-PJ-NAME-LC': {
@@ -408,51 +408,51 @@ rules = {
         rule: '<code>package.json</code> property <code>"name"</code> must be lowercase',
         details: oneLineTrim`The property <code>"name"</code> in your <code>package.json</code> file must be lowercase.<br>
         Good examples are: <code>"my-theme"</code> or <code>"theme"</code> rather than <code>"My Theme"</code> or <code>"Theme"</code>.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-NAME-HY': {
         level: 'error',
         rule: '<code>package.json</code> property <code>"name"</code> must be hyphenated',
         details: oneLineTrim`The property <code>"name"</code> in your <code>package.json</code> file must be hyphenated.<br>
         Please use <code>"my-theme"</code> rather than <code>"My Theme"</code> or <code>"my theme"</code>.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-NAME-REQ': {
         level: 'error',
         rule: '<code>package.json</code> property <code>"name"</code> is required',
         details: oneLineTrim`Please add the property <code>"name"</code> to your <code>package.json</code>. E.g. <code>{"name": "my-theme"}</code>.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> to see which properties are required and which are recommended.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> to see which properties are required and which are recommended.`
     },
     'GS010-PJ-VERSION-SEM': {
         level: 'error',
         rule: '<code>package.json</code> property <code>"version"</code> must be semver compliant',
         details: oneLineTrim`The property <code>"version"</code> in your <code>package.json</code> file must be semver compliant. E.g. <code>{"version": "1.0.0"}</code>.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-VERSION-REQ': {
         level: 'error',
         rule: '<code>package.json</code> property <code>"version"</code> is required',
         details: oneLineTrim`Please add the property <code>"version"</code> to your <code>package.json</code>. E.g. <code>{"version": "1.0.0"}</code>.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> to see which properties are required and which are recommended.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> to see which properties are required and which are recommended.`
     },
     'GS010-PJ-AUT-EM-VAL': {
         level: 'error',
         rule: '<code>package.json</code> property <code>"author.email"</code> must be valid',
         details: oneLineTrim`The property <code>"author.email"</code> in your <code>package.json</code> file must a valid email. E.g. <code>{"author": {"email": "hello@example.com"}}</code>.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-CONF-PPP': {
         level: 'recommendation',
         rule: '<code>package.json</code> property <code>"config.posts_per_page"</code> is recommended. Otherwise, it falls back to 5',
         details: oneLineTrim`Please add <code>"posts_per_page"</code> to your <code>package.json</code>. E.g. <code>{"config": { "posts_per_page": 5}}</code>.<br>
         If no <code>"posts_per_page"</code> property is provided, Ghost will use its default setting of 5 posts per page.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-CONF-PPP-INT': {
         level: 'error',
         rule: '<code>package.json</code> property <code>"config.posts_per_page"</code> must be a number above 0',
         details: oneLineTrim`The property <code>"config.posts_per_page"</code> in your <code>package.json</code> file must be a number greater than zero. E.g. <code>{"config": { "posts_per_page": 5}}</code>.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-AUT-EM-REQ': {
         level: 'error',
@@ -461,14 +461,14 @@ rules = {
         The email is required so that themes which are distributed (either free or paid) have a method of contacting the author so users can get support and more importantly so that>
         Ghost can reach out about breaking changes and security updates.<br>
         The <code>package.json</code> file is <strong>NOT</strong> accessible when uploaded to a blog so if the theme is only uploaded to a single blog, no one will see this email address.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> to see which properties are required and which are recommended.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> to see which properties are required and which are recommended.`
     },
     'GS020-INDEX-REQ': {
         level: 'error',
         rule: 'A template file called <code>index.hbs</code> must be present',
         fatal: true,
         details: oneLineTrim`Your theme must have a template file called <code>index.hbs</code>.<br>
-        Read <a href="${docsBaseUrl}context/" target=_blank>here</a> more about the required template structure and <code>index.hbs</code> in <a href="${docsBaseUrl}context/index/" target=_blank>particular</a>.`,
+        Read <a href="${docsBaseUrl}contexts/" target=_blank>here</a> more about the required template structure and <code>index.hbs</code> in <a href="${docsBaseUrl}contexts/index-context/" target=_blank>particular</a>.`,
         path: 'index.hbs'
     },
     'GS020-POST-REQ': {
@@ -476,14 +476,14 @@ rules = {
         rule: 'A template file called <code>post.hbs</code> must be present',
         fatal: true,
         details: oneLineTrim`Your theme must have a template file called <code>index.hbs</code>.<br>
-        Read <a href="${docsBaseUrl}templates" target=_blank>here</a> more about the required template structure and <code>post.hbs</code> in <a href="${docsBaseUrl}templates#section-post-hbs" target=_blank>particular</a>.`,
+        Read <a href="${docsBaseUrl}structure/#templates" target=_blank>here</a> more about the required template structure and <code>post.hbs</code> in <a href="${docsBaseUrl}structure/#posthbs" target=_blank>particular</a>.`,
         path: 'post.hbs'
     },
     'GS020-DEF-REC': {
         level: 'recommendation',
         rule: 'Provide a default layout template called default.hbs',
         details: oneLineTrim`It is recommended that your theme has a template file called <code>default.hbs</code>.<br>
-        Read <a href="${docsBaseUrl}templates" target=_blank>here</a> more about the recommended template structure and <code>default.hbs</code> in <a href="${docsBaseUrl}templates#section-default-hbs" target=_blank>particular</a>.`,
+        Read <a href="${docsBaseUrl}structure/#templates" target=_blank>here</a> more about the recommended template structure and <code>default.hbs</code> in <a href="${docsBaseUrl}structure/#defaulthbs" target=_blank>particular</a>.`,
         path: 'default.hbs'
     },
     'GS030-ASSET-REQ': {

package/lib/specs/v2.js

@@ -2,7 +2,9 @@ const _ = require('lodash');
 const oneLineTrim = require('common-tags/lib/oneLineTrim');
 const previousSpec = require('./v1');
 const ghostVersions = require('../utils').versions;
-const docsBaseUrl = `https://ghost.org/docs/api/handlebars-themes/`;
+const docsBaseUrl = `https://ghost.org/docs/themes/`;
+// TODO: we don't use versioned docs anymore and the previous rules should only contain
+// correct links. The usage of replacing the previousBaseUrl can probably be removed
 const prevDocsBaseUrl = `https://themes.ghost.org/v${ghostVersions.v1.docs}/docs/`;
 const prevDocsBaseUrlRegEx = new RegExp(prevDocsBaseUrl, 'g');
 
@@ -16,7 +18,7 @@ function requiredClassRule(strings) {
 
 function requiredClassDetails(strings) {
     return oneLineTrim`The <code>.${strings[0]}</code> CSS class is required otherwise wide images will appear unstyled.
-    Find out more about required theme changes for the Koenig editor <a href="${docsBaseUrl}editor/" target=_blank>here</a>.`;
+    Find out more about required theme changes for the Koenig editor <a href="${docsBaseUrl}content/" target=_blank>here</a>.`;
 }
 
 // assign new or overwrite existing knownHelpers, templates, or rules here:
@@ -367,7 +369,7 @@ let rules = {
         rule: 'Replace <code>{{post.author_id}}</code> code with <code>{{post.primary_author.id}}</code>',
         details: oneLineTrim`The <code>{{post.author_id}}</code> attribute in post context was removed<br>
         Instead of <code>{{post.author_id}}</code> you need to use <code>{{post.primary_author.id}}</code>.<br>
-        See the object attributes of <code>post</code> <a href="${docsBaseUrl}context/post/#post-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>post</code> <a href="${docsBaseUrl}contexts/post/#post-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?post\.author_id\s*?}}/g,
         helper: '{{post.author_id}}'
     },
@@ -448,7 +450,7 @@ let rules = {
         rule: `<code>.kg-card-markdown</code> doesn't exist in current version of Ghost, ensure your theme works without it`,
         details: oneLineTrim`The <code>.kg-card-markdown</code> CSS class is deprecated and will no longer be used in Ghost.
         It's recommended to add your own wrapper around the <code>{{content}}</code> helper and target that instead if needed.
-        Find out more about required theme changes for the Koenig editor <a href="${docsBaseUrl}editor/" target=_blank>here</a>.`,
+        Find out more about required theme changes for the Koenig editor <a href="${docsBaseUrl}content/" target=_blank>here</a>.`,
         regex: /\.kg-card-markdown/g,
         className: '.kg-card-markdown',
         css: true
@@ -593,7 +595,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{author.cover}}</code> you need to use
         <code>{{primary_author.cover_image}}</code> or <code>{{authors.[#].cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?author\.cover\s*?}}/g,
         helper: '{{author.cover}}'
     },
@@ -603,7 +605,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{primary_author.cover}}</code> you need to use
         <code>{{primary_author.cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?primary_author\.cover\s*?}}/g,
         helper: '{{primary_author.cover}}'
     },
@@ -613,7 +615,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{authors.[#].cover}}</code> you need to use
         <code>{{authors.[#].cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?authors\.\[[0-9]+\]\.(cover)\s*?}}/g,
         helper: '{{authors.[#].cover}}'
     },
@@ -624,7 +626,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{author.image}}</code>, you need to use
         <code>{{primary_author.profile_image}}</code> or <code>{{authors.[#].profile_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?author\.image\s*?}}/g,
         helper: '{{author.image}}'
     },
@@ -634,7 +636,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{primary_author.image}}</code>, you need to use
         <code>{{primary_author.profile_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?primary_author\.(image)\s*?}}/g,
         helper: '{{primary_author.image}}'
     },
@@ -644,7 +646,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{authors.[#].image}}</code>, you need to use
         <code>{{authors.[#].profile_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?authors\.\[[0-9]+\]\.(cover)\s*?}}/g,
         helper: '{{authors.[#].image}}'
     },
@@ -655,7 +657,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{post.author.cover}}</code>, you need to use
         <code>{{post.primary_author.cover_image}}</code> or <code>{{post.authors.[#].cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?post\.author\.cover\s*?}}/g,
         helper: '{{post.author.cover}}'
     },
@@ -665,7 +667,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{post.primary_author.cover}}</code>, you need to use
         <code>{{post.primary_author.cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?post\.primary_author\.cover\s*?}}/g,
         helper: '{{post.primary_author.cover}}'
     },
@@ -675,7 +677,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{post.authors.[#].cover}}</code>, you need to use
         <code>{{post.authors.[#].cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?post\.authors\.\[[0-9]+\]\.(cover)\s*?}}/g,
         helper: '{{post.authors.[#].cover}}'
     },
@@ -686,7 +688,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{post.author.image}}</code>, you need to use
         <code>{{post.primary_author.profile_image}}</code> or <code>{{post.authors.[#].profile_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?post\.author\.image\s*?}}/g,
         helper: '{{post.author.image}}'
     },
@@ -696,7 +698,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{post.primary_author.image}}</code>, you need to use
         <code>{{post.primary_author.profile_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?post\.primary_author\.image\s*?}}/g,
         helper: '{{post.primary_author.image}}'
     },
@@ -706,7 +708,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{post.authors.[#].image}}</code>, you need to use
         <code>{{post.authors.[#].profile_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?post\.authors\.\[[0-9]+\]\.(image)\s*?}}/g,
         helper: '{{post.authors.[#].image}}'
     },
@@ -717,7 +719,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{#if author.cover}}</code>, you need to use
         <code>{{#if primary_author.cover_image}}</code> or <code>{{#if authors.[#].cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?author\.cover\s*?}}/g,
         helper: '{{#if author.cover}}'
     },
@@ -728,7 +730,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{#if primary_author.cover}}</code>, you need to use
         <code>{{#if primary_author.cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?primary_author\.cover\s*?}}/g,
         helper: '{{#if primary_author.cover}}'
     },
@@ -739,7 +741,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{#if authors.[#].cover}}</code>, you need to use
         <code>{{#if authors.[#].cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?authors\.\[[0-9]+\]\.cover\s*?}}/g,
         helper: '{{#if authors.[#].cover}}'
     },
@@ -750,7 +752,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{#if author.image}}</code>, you need to use
         <code>{{#if primary_author.profile_image}}</code> or <code>{{#if authors.[#].profile_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?author\.image\s*?}}/g,
         helper: '{{#if author.image}}'
     },
@@ -760,7 +762,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{#if primary_author.image}}</code>, you need to use
         <code>{{#if primary_author.profile_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?primary_author\.image\s*?}}/g,
         helper: '{{#if primary_author.image}}'
     },
@@ -770,7 +772,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{#if authors.[#].image}}</code>, you need to use
         <code>{{#if authors.[#].profile_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?authors\.\[[0-9]+\]\.image\s*?}}/g,
         helper: '{{#if authors.[#].image}}'
     },
@@ -781,7 +783,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{#if post.author.cover}}</code>, you need to use
         <code>{{#if post.primary_author.cover_image}}</code> or <code>{{#if post.authors.[#].cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?post\.author\.cover\s*?}}/g,
         helper: '{{#if post.author.cover}}'
     },
@@ -791,7 +793,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{#if post.primary_author.cover}}</code>, you need to use
         <code>{{#if post.primary_author.cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?post\.primary_author\.cover\s*?}}/g,
         helper: '{{#if post.primary_author.cover}}'
     },
@@ -801,7 +803,7 @@ let rules = {
         details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
         Instead of <code>{{#if post.authors.[#].cover}}</code>, you need to use
         <code>{{#if post.authors.[#].cover_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?post\.authors\.\[[0-9]+\]\.cover\s*?}}/g,
         helper: '{{#if post.authors.[#].cover}}'
     },
@@ -812,7 +814,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{#if post.author.image}}</code>, you need to use
         <code>{{#if post.primary_author.profile_image}}</code> or <code>{{#if post.authors.[#].profile_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?post\.author\.image\s*?}}/g,
         helper: '{{#if post.author.image}}'
     },
@@ -822,7 +824,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{#if post.primary_author.image}}</code>, you need to use
         <code>{{#if post.primary_author.profile_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?post\.primary_author\.image\s*?}}/g,
         helper: '{{#if post.primary_author.image}}'
     },
@@ -832,7 +834,7 @@ let rules = {
         details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
         Instead of <code>{{#if post.authors.[#].image}}</code>, you need to use
         <code>{{#if post.authors.[#].profile_image}}</code>.<br>
-        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}contexts/author/#author-object-attributes" target=_blank>here</a>.`,
         regex: /{{\s*?#if\s*?post\.authors\.\[[0-9]+\]\.image\s*?}}/g,
         helper: '{{#if post.authors.[#].image}}'
     },
@@ -841,7 +843,7 @@ let rules = {
         level: 'warning',
         rule: '<code>package.json</code> property <code>keywords</code> should contain <code>ghost-theme</code>',
         details: oneLineTrim`The property <code>keywords</code> in your <code>package.json</code> file must contain <code>ghost-theme</code>. E.g. <code>{"keywords": ["ghost-theme"]}</code>.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     }
 };
 

package/lib/specs/v3.js

@@ -2,8 +2,9 @@ const _ = require('lodash');
 const oneLineTrim = require('common-tags/lib/oneLineTrim');
 const previousSpec = require('./v2');
 const ghostVersions = require('../utils').versions;
-const docsBaseUrl = `https://ghost.org/docs/api/handlebars-themes/`;
-const faqBaseUrl = `https://ghost.org/faq/`;
+const docsBaseUrl = `https://ghost.org/docs/themes/`;
+// TODO: we don't use versioned docs anymore and the previous rules should only contain
+// correct links. The usage of replacing the previousBaseUrl can probably be removed
 const prevDocsBaseUrl = `https://themes.ghost.org/v${ghostVersions.v2.docs}/docs/`;
 const prevDocsBaseUrlRegEx = new RegExp(prevDocsBaseUrl, 'g');
 
@@ -21,14 +22,14 @@ let rules = {
         rule: '<code>package.json</code> property <code>"engines.ghost-api"</code> is recommended. Otherwise, it falls back to "v3"',
         details: oneLineTrim`Please add <code>"ghost-api"</code> to your <code>package.json</code>. E.g. <code>{"engines": {"ghost-api": "v3"}}</code>.<br>
         If no <code>"ghost-api"</code> property is provided, Ghost will use its default setting of "v3" Ghost API.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-GHOST-API-V01': {
         level: 'error',
         rule: '<code>package.json</code> property <code>"engines.ghost-api"</code> is incompatible with current version of Ghost API and will fall back to "v3"',
         details: oneLineTrim`Please change <code>"ghost-api"</code> in your <code>package.json</code> to higher version. E.g. <code>{"engines": {"ghost-api": "v3"}}</code>.<br>
         If <code>"ghost-api"</code> property is left at "v0.1", Ghost will use its default setting of "v3".<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS001-DEPR-ESC': {
         level: 'error',
@@ -43,7 +44,7 @@ let rules = {
         level: 'error',
         rule: 'The v0.1 API and <code>ghost.url.api()</code> JavaScript helper have been removed.',
         details: oneLineTrim`The v0.1 API & Public API Beta have been removed, along with the <code>public/ghost-sdk.min.js</code> file & the <code>ghost.url.api()</code> helper.<br>
-        All code relying on the v0.1 API must be upgraded to use the <a href="${faqBaseUrl}upgrades/" target=_blank>new API</a>.`,
+        All code relying on the v0.1 API must be upgraded to use the <a href="https://ghost.org/docs/changes/" target=_blank>new API</a>.`,
         regex: /ghost\.url\.api/g
     },
     'GS070-VALID-TRANSLATIONS': {

package/lib/specs/v4.js

@@ -3,6 +3,8 @@ const oneLineTrim = require('common-tags/lib/oneLineTrim');
 const previousSpec = require('./v3');
 const ghostVersions = require('../utils').versions;
 const docsBaseUrl = `https://ghost.org/docs/themes/`;
+// TODO: we don't use versioned docs anymore and the previous rules should only contain
+// correct links. The usage of replacing the previousBaseUrl can probably be removed
 const prevDocsBaseUrl = `https://themes.ghost.org/v${ghostVersions.v3.docs}/docs/`;
 const prevDocsBaseUrlRegEx = new RegExp(prevDocsBaseUrl, 'g');
 
@@ -15,7 +17,7 @@ function cssCardRule(cardName, className) {
         level: 'warning',
         rule: `The <code>.${className}</code> CSS class is required to appear styled in your theme`,
         details: oneLineTrim`The <code>.${className}</code> CSS class is required otherwise the ${cardName} card will appear unstyled.
-        Find out more about required theme changes for the Koenig editor <a href="${docsBaseUrl}editor/" target=_blank>here</a>.`,
+        Find out more about required theme changes for the Koenig editor <a href="${docsBaseUrl}content/" target=_blank>here</a>.`,
         regex: new RegExp(`\\.${className}`, 'g'),
         className: `.${className}`,
         css: true,
@@ -33,75 +35,75 @@ let rules = {
         rule: '<code>package.json</code> property <code>"engines.ghost-api"</code> is deprecated.',
         details: oneLineTrim`Remove <code>"ghost-api"</code> from your <code>package.json</code>.<br>
         The <code>ghost-api</code> support will be removed in next major version of Ghost and should not be used.
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-GHOST-API-V01': {
         level: 'error',
         rule: '<code>package.json</code> property <code>"engines.ghost-api"</code> is incompatible with current version of Ghost API and will fall back to "v4"',
         details: oneLineTrim`Change <code>"ghost-api"</code> in your <code>package.json</code> to higher version. E.g. <code>{"engines": {"ghost-api": "v4"}}</code>.<br>
         If <code>"ghost-api"</code> property is left at "v0.1", Ghost will use its default setting of "v4".<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-GHOST-API-V2': {
         level: 'warning',
         rule: '<code>package.json</code> property <code>"engines.ghost-api"</code> is using a deprecated version of Ghost API',
         details: oneLineTrim`Change <code>"ghost-api"</code> in your <code>package.json</code> to higher version. E.g. <code>{"engines": {"ghost-api": "v4"}}</code>.<br>
         If <code>"ghost-api"</code> property is left at "v2", it will stop working with next major version upgrade and default to v5.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-CUST-THEME-TOTAL-SETTINGS': {
         level: 'error',
         rule: '<code>package.json</code> property <code>"config.custom"</code> contains too many settings',
         details: oneLineTrim`Remove key from <code>"config.custom"</code> in your <code>package.json</code> to have less than or exactly 15 settings.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-CUST-THEME-SETTINGS-CASE': {
         level: 'error',
         rule: '<code>package.json</code> property <code>"config.custom"</code> contains a property that isn\'t snake-cased',
         details: oneLineTrim`Rewrite all property in <code>"config.custom"</code> in your <code>package.json</code> in snake case.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-CUST-THEME-SETTINGS-TYPE': {
         level: 'error',
         rule: '<code>package.json</code> objects defined in <code>"config.custom"</code> should have a known <code>"type"</code>.',
         details: oneLineTrim`Only use the following types: <code>"select"</code>, <code>"boolean"</code>, <code>"color"</code>, <code>"image"</code>, <code>"text"</code>.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-CUST-THEME-SETTINGS-GROUP': {
         level: 'recommendation',
         rule: '<code>package.json</code> objects defined in <code>"config.custom"</code> should have a known <code>"group"</code>.',
         details: oneLineTrim`Only use the following groups: <code>"post"</code>, <code>"homepage"</code>.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-CUST-THEME-SETTINGS-SELECT-OPTIONS': {
         level: 'error',
         rule: '<code>package.json</code> objects defined in <code>"config.custom"</code> of type <code>"select"</code> need to have at least 2 <code>"options"</code>.',
         details: oneLineTrim`Make sure there is at least 2 <code>"options"</code> in each <code>"select"</code> custom theme property.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-CUST-THEME-SETTINGS-SELECT-DEFAULT': {
         level: 'error',
         rule: '<code>package.json</code> objects defined in <code>"config.custom"</code> of type <code>"select"</code> need to have a valid <code>"default"</code>.',
         details: oneLineTrim`Make sure the <code>"default"</code> property matches a value in <code>"options"</code> of the same <code>"select"</code>.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-CUST-THEME-SETTINGS-BOOLEAN-DEFAULT': {
         level: 'error',
         rule: '<code>package.json</code> objects defined in <code>"config.custom"</code> of type <code>"boolean"</code> need to have a valid <code>"default"</code>.',
         details: oneLineTrim`Make sure the <code>"default"</code> property is either <code>true</code> or <code>false</code>.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-CUST-THEME-SETTINGS-COLOR-DEFAULT': {
         level: 'error',
         rule: '<code>package.json</code> objects defined in <code>"config.custom"</code> of type <code>"color"</code> need to have a valid <code>"default"</code>.',
         details: oneLineTrim`Make sure the <code>"default"</code> property is a valid 6-hexadecimal-digit color code like <code>#15171a</code>.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS010-PJ-CUST-THEME-SETTINGS-IMAGE-DEFAULT': {
         level: 'error',
         rule: '<code>package.json</code> objects defined in <code>"config.custom"</code> of type <code>"image"</code> can\'t have a <code>"default"</code> value.',
         details: oneLineTrim`Make sure the <code>"default"</code> property is either <code>null</code>, an empty string <code>''</code> or isn't present.<br>
-        Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
+        Check the <a href="${docsBaseUrl}structure/#packagejson" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
     'GS001-DEPR-LABS-MEMBERS': {
         level: 'warning',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gscan",
-  "version": "4.29.1",
+  "version": "4.29.2",
   "description": "Scans Ghost themes looking for errors, deprecations, features and compatibility",
   "keywords": [
     "ghost",
@@ -8,7 +8,7 @@
     "validator",
     "lint"
   ],
-  "homepage": "https://ghost.org",
+  "homepage": "https://ghost.org/",
   "repository": {
     "type": "git",
     "url": "git@github.com:TryGhost/gscan.git"
@@ -22,7 +22,7 @@
   "author": {
     "name": "Ghost Foundation",
     "email": "hello@ghost.org",
-    "web": "https://ghost.org"
+    "web": "https://ghost.org/"
   },
   "main": "lib",
   "license": "MIT",