docs(app): add dedicated Troubleshooting page

_config.yml

@@ -78,7 +78,7 @@ highlighted:
     - /tools/cli/start
     - /platform/app/log-drain
     - /platform/deployment/deployment-process
-    - /platform/getting-started/common-deployment-errors
+    - /platform/app/troubleshooting/deployment-issues
     - /languages/nodejs/start
     - /languages/php/start
     - /databases/postgresql/about/overview

assets/style.css

@@ -1134,3 +1134,63 @@ source: https://weblog.west-wind.com/posts/2016/feb/15/flexbox-containers-pre-ta
 div, span, html, body, ul, article, main, nav {
   min-width: 0;
 }
+
+
+ol.deploy-timeline {
+    border-left: 4px solid var(--color-primary-gray-200);
+    margin: 1rem 0 1rem 1rem;
+
+    li {
+        display: flex;
+        font-weight: 300;
+        line-height: 2rem;
+        list-style-type: none;
+        margin-left: -1.1rem;
+        padding: 0;
+
+       &::before {
+            background-color: var(--color-primary-gray-200);
+            border-radius: 50%;
+            border: 1px solid var(--color-primary-gray-200);
+            color: #FFF;
+            content: "\00A0"; /* non-breakbale space */
+            display: inline-block;
+            font-family: var(--font-mono);
+            font-size: 1.25rem;
+            font-weight: 600;
+            height: 2rem;
+            line-height: 2rem;
+            margin-right: 1rem;
+            text-align: center;
+            width: 2rem;
+        }
+
+        &.ok {
+            font-weight: 400;
+
+            &::before {
+                background-color: var(--color-state-success-700);
+                content: "\2713"; /* ✓ (check mark) */
+            }
+        }
+
+        &.cur {
+            font-weight: 600;
+
+            &::before {
+                background-color: var(--color-warning-500);
+                content: "\2022"; /* • (bullet) */
+            }
+        }
+
+        span {
+            background-color: var(--color-primary-gray-200);
+            border-radius: 5px;
+            font-family: var(--font-mono);
+            font-size: 0.8rem;
+            font-weight: 400;
+            margin-right: 1rem;
+            padding: 0 0.5rem;
+        }
+    }
+}

redirections.yml

@@ -864,6 +864,15 @@
   - old: "/platform/app/notification"
     new: "/platform/app/notifiers"
 
+  - old: "/platform/getting-started/common-deployment-errors"
+    new: "/platform/app/troubleshooting/deployment-issues"
+
+  - old: "/platform/app/crash"
+    new: "/platform/app/troubleshooting/boot-errors"
+
+  - old: "/platform/deployment/unknown-technology"
+    new: "/platform/app/troubleshooting/deployment-issues#unknown-technology"
+
 obsolete:
   - "/how-to-migrate-from-cloudcontrol/"
   - "/how-to-migrate-from-shelly-cloud/"

src/_includes/language_start_pages.md

@@ -0,0 +1,13 @@
+{::comment}
+Keep this list sorted alphabetically to match the detection order.
+{:/comment}
+* [Clojure]({% post_url languages/clojure/2000-01-01-start %})
+* [Go]({% post_url languages/go/2000-01-01-start %})
+* [Groovy]({% post_url languages/groovy/2000-01-01-start %})
+* [Java]({% post_url languages/java/2000-01-01-start %})
+* [Meteor]({% post_url languages/meteorjs/2000-01-01-start %})
+* [Node.js]({% post_url languages/nodejs/2000-01-01-start %})
+* [PHP]({% post_url languages/php/2000-01-01-start %})
+* [Python]({% post_url languages/python/2000-01-01-start %})
+* [Ruby]({% post_url languages/ruby/2000-01-01-start %})
+* [Scala]({% post_url languages/scala/2000-01-01-start %})

src/_plugins/jekyll-deploytl-tag.rb

@@ -0,0 +1,52 @@
+module Jekyll
+  class DeployTimelineTag < Liquid::Tag
+    def initialize(tag_name, markup, tokens)
+      super
+      @steps = parse_steps(markup)
+    end
+
+    def render(context)
+      first_ok = @steps.min
+
+      html = "<ol class=\"deploy-timeline\">\n"
+      html << %Q{<li#{class_attr(1, first_ok)}><span>building</span> Source fetched</li>\n}
+      html << %Q{<li#{class_attr(2, first_ok)}><span>building</span> Technology detected</li>\n}
+      html << %Q{<li#{class_attr(3, first_ok)}><span>building</span> Application image built</li>\n}
+      html << %Q{<li#{class_attr(4, first_ok)}><span>starting</span> Container started</li>\n}
+      html << %Q{<li#{class_attr(5, first_ok)}><span>starting</span> Postdeploy hook run</li>\n}
+      html << %Q{<li#{class_attr(6, first_ok)}><span>running&nbsp;</span> Application running</li>\n}
+      html << "</ol>"
+
+      html
+    end
+
+    private
+
+    def class_attr(step, first_ok)
+      if @steps.include?(step)
+        ' class="cur"'
+      elsif first_ok && step < first_ok
+        ' class="ok"'
+      else
+        ''
+      end
+    end
+
+    def parse_steps(markup)
+      match = markup.match(/steps="([^"]+)"/)
+      return [] unless match
+
+      value = match[1]
+
+      if value.include?("-")
+        start_s, end_s = value.split("-").map(&:to_i)
+        (start_s..end_s).to_a
+      else
+        [value.to_i]
+      end
+    end
+  end
+end
+
+
+Liquid::Template.register_tag("deploytl", Jekyll::DeployTimelineTag)

src/_posts/platform/app/2000-01-01-postdeploy-hook.md

@@ -1,6 +1,6 @@
 ---
 title: Post-deployment hook
-modified_at: 2023-12-22 00:00:00
+modified_at: 2026-04-29 00:00:00
 tags: app deployment hook postdeploy
 index: 13
 ---
@@ -32,7 +32,7 @@ happen in the following order:
 2. Containers from the new version of the application are started
 3. We wait until they started successfully (see common [deployment start
    errors]({% post_url
-   platform/getting-started/2000-01-01-common-deployment-errors
+   platform/app/troubleshooting/2000-01-01-boot-errors
    %}#start-errors)). They are not reachable yet, see [limits](#limits) below.
 4. An extra container is started to run the `postdeploy` command
 5. If the `postdeploy` command succeeds, we update the routing