From 6484425ec239d91ace4403c4ac3fe38f12c53a5f Mon Sep 17 00:00:00 2001
From: oppiliappan <me@oppi.li>
Date: Wed, 7 Jan 2026 03:10:47 +0000
Subject: [PATCH] docs: move intro to index page as the abstract
Change-Id: vpvwrlkoxoznwuoprvpyzswqpouvpqzq

Signed-off-by: oppiliappan <me@oppi.li>
---
 docs/DOCS.md       | 52 ++++++++++++++++++++++------------------------
 docs/template.html | 43 +++++++++++++++++++-------------------
 2 files changed, 47 insertions(+), 48 deletions(-)

diff --git a/docs/DOCS.md b/docs/DOCS.md
index 9bc7bbf7..ff126493 100644
--- a/docs/DOCS.md
+++ b/docs/DOCS.md
@@ -2,35 +2,33 @@
 title: Tangled docs
 author: The Tangled Contributors
 date: 21 Sun, Dec 2025
+abstract: |
+    Tangled is a decentralized code hosting and collaboration
+    platform. Every component of Tangled is open-source and
+    self-hostable. [tangled.org](https://tangled.org) also
+    provides hosting and CI services that are free to use.
+
+    There are several models for decentralized code
+    collaboration platforms, ranging from ActivityPub’s
+    (Forgejo) federated model, to Radicle’s entirely P2P model.
+    Our approach attempts to be the best of both worlds by
+    adopting the AT Protocol—a protocol for building decentralized
+    social applications with a central identity
+
+    Our approach to this is the idea of “knots”. Knots are
+    lightweight, headless servers that enable users to host Git
+    repositories with ease. Knots are designed for either single
+    or multi-tenant use which is perfect for self-hosting on a
+    Raspberry Pi at home, or larger “community” servers. By
+    default, Tangled provides managed knots where you can host
+    your repositories for free.
+
+    The appview at tangled.org acts as a consolidated "view"
+    into the whole network, allowing users to access, clone and
+    contribute to repositories hosted across different knots
+    seamlessly.
 ---
 
-# Introduction
-
-Tangled is a decentralized code hosting and collaboration
-platform. Every component of Tangled is open-source and
-self-hostable. [tangled.org](https://tangled.org) also
-provides hosting and CI services that are free to use.
-
-There are several models for decentralized code
-collaboration platforms, ranging from ActivityPub’s
-(Forgejo) federated model, to Radicle’s entirely P2P model.
-Our approach attempts to be the best of both worlds by
-adopting the AT Protocol—a protocol for building decentralized
-social applications with a central identity
-
-Our approach to this is the idea of “knots”. Knots are
-lightweight, headless servers that enable users to host Git
-repositories with ease. Knots are designed for either single
-or multi-tenant use which is perfect for self-hosting on a
-Raspberry Pi at home, or larger “community” servers. By
-default, Tangled provides managed knots where you can host
-your repositories for free.
-
-The appview at tangled.org acts as a consolidated "view"
-into the whole network, allowing users to access, clone and
-contribute to repositories hosted across different knots
-seamlessly.
-
 # Quick start guide
 
 ## Login or sign up
diff --git a/docs/template.html b/docs/template.html
index 916a4a4c..67a8b7c2 100644
--- a/docs/template.html
+++ b/docs/template.html
@@ -90,7 +90,7 @@
                p-4 z-50 overflow-y-auto">
         <div class="flex-1">
           $if(toc-title)$
-          <h2 id="$idprefix$toc-title" class="text-lg font-semibold mb-4 text-gray-900">$toc-title$</h2>
+            <h2 id="$idprefix$toc-title" class="text-lg font-semibold mb-4 text-gray-900">$toc-title$</h2>
           $endif$
           ${ table-of-contents:toc.html() }
         </div>
@@ -101,29 +101,30 @@
     <div class="$if(toc)$md:ml-80$endif$ flex-1 flex flex-col">
       <main class="max-w-4xl w-full mx-auto p-6 flex-1">
         $if(top)$
-        $-- only print title block if this is NOT the top page
+          $-- only print title block if this is NOT the top page
         $else$
         $if(title)$
-        <header id="title-block-header" class="mb-8 pb-8 border-b border-gray-200 dark:border-gray-700">
-          <h1 class="text-4xl font-bold mb-2 text-black dark:text-white">$title$</h1>
-          $if(subtitle)$
-          <p class="text-xl text-gray-500 dark:text-gray-400 mb-2">$subtitle$</p>
-          $endif$
-          $for(author)$
-          <p class="text-sm text-gray-500 dark:text-gray-400">$author$</p>
-          $endfor$
-          $if(date)$
-          <p class="text-sm text-gray-500 dark:text-gray-400">Updated on $date$</p>
-          $endif$
-          $if(abstract)$
-          <div class="mt-6 p-4 bg-gray-50 rounded-lg">
-            <div class="text-sm font-semibold text-gray-700 uppercase mb-2">$abstract-title$</div>
-            <div class="text-gray-700">$abstract$</div>
-          </div>
-          $endif$
-          $endif$
-        </header>
+          <header id="title-block-header" class="mb-8 pb-8 border-b border-gray-200 dark:border-gray-700">
+            <h1 class="text-4xl font-bold mb-2 text-black dark:text-white">$title$</h1>
+              $if(subtitle)$
+                <p class="text-xl text-gray-500 dark:text-gray-400 mb-2">$subtitle$</p>
+              $endif$
+              $for(author)$
+                <p class="text-sm text-gray-500 dark:text-gray-400">$author$</p>
+              $endfor$
+              $if(date)$
+                <p class="text-sm text-gray-500 dark:text-gray-400">Updated on $date$</p>
+              $endif$
+            $endif$
+          </header>
         $endif$
+
+        $if(abstract)$
+          <article class="prose dark:prose-invert max-w-none">
+            $abstract$
+          </article>
+        $endif$
+
         <article class="prose dark:prose-invert max-w-none">
           $body$
         </article>
-- 
2.43.0