docs: add introduction for guidance

Signed-off-by: David Dal Busco <david.dalbusco@outlook.com>

Author: peterpeterparker

docs/start-a-new-project.mdx

@@ -1,16 +1,24 @@
 ---
-description: Build a full-stack app with Juno — scaffold a new project using your favorite frontend framework, or integrate Juno into an existing codebase with serverless functions, data, and local emulator support.---
+description: Build a full-stack app with Juno — whether you're using a template, starting from scratch, or adding it to an existing project.
 ---
 
 # Start a New Project
 
 With Juno, a project typically lives in a single repository — combining your frontend, serverless functions, and configuration. Whether you're starting from scratch or extending an existing app, the result is a full-stack project that deploys as a single container.
 
-Choose the path that fits where you are in your journey:
+---
+
+## 🧭 Choose Your Starting Point
+
+There are multiple ways to start a Juno project. Pick what fits best:
+
+- [Use a Juno Template](#-scaffold-with-a-juno-template) if you want everything preconfigured
+- [Bring Your Own Framework](#-start-with-your-favorite-framework) if you’ve already picked a stack
+- [Add Juno to an Existing Project](#-add-juno-to-an-existing-project) for incremental adoption
 
 ---
 
-## 🚀 1. Scaffold with a Juno Template
+## 🚀 Scaffold with a Juno Template
 
 One way to get started is by scaffolding a full-stack project using our prebuilt templates — it sets up your frontend framework of choice along with serverless functions and emulator support.
 
@@ -30,7 +38,7 @@ Supports Astro, Next.js, React, SvelteKit, Vue, and Angular.
 
 ---
 
-## ✨ 2. Start with Your Favorite Framework
+## ✨ Start with Your Favorite Framework
 
 Prefer to begin with `npx create-next-app`, `npm create svelte@latest`, or any other starter you know well? Totally fine. Set up your frontend however you like, then bring in Juno afterward.
 
@@ -51,7 +59,7 @@ This gives you full flexibility while keeping everything in one repo.
 
 ---
 
-## 🧩 3. Add Juno to an Existing Project
+## 🧩 Add Juno to an Existing Project
 
 Already have a project in development or production? You can integrate Juno incrementally.