From 2ffa3f2a59afe19f4163cca1afcebd43f9453860 Mon Sep 17 00:00:00 2001
From: "Amir H. Hashemi" <87268103+amirhhashemi@users.noreply.github.com>
Date: Fri, 3 Jul 2026 17:11:56 +0330
Subject: [PATCH 1/2] Add introduction for v2 docs

---
 src/routes/v2/(0)index.mdx           | 12 +++++++++++-
 src/routes/v2/(1)getting-started.mdx | 27 +++++++++++++++++++++++++++
 2 files changed, 38 insertions(+), 1 deletion(-)
 create mode 100644 src/routes/v2/(1)getting-started.mdx

diff --git a/src/routes/v2/(0)index.mdx b/src/routes/v2/(0)index.mdx
index 1cefd07c6..ca64a1905 100644
--- a/src/routes/v2/(0)index.mdx
+++ b/src/routes/v2/(0)index.mdx
@@ -17,4 +17,14 @@ description: >-
   Learn about fine-grained reactivity and modern web development.
 ---
 
-Solid v2 is currently in beta. Expect more docs to appear here soon!
+:::note[Documentation is currently under construction]
+Like Solid v2, this documentation is in beta.
+You may encounter missing content or rough edges in the tooling surrounding Solid v2.
+We are actively working to improve these aspects and expand the available content.
+If you're seeking a more stable experience, please refer to the [Solid v1 documentation](/).
+:::
+
+Solid is a framework for building user interfaces (UIs) on the web.
+You can use it to create anything from small personal projects to complex full-stack applications (with Solid's full-stack framework, [SolidStart](/solid-start)), and everything in between.
+
+You can try Solid online in the [playground](https://playground.solidjs.com/) or [start a project](/v2/getting-started) right away!
diff --git a/src/routes/v2/(1)getting-started.mdx b/src/routes/v2/(1)getting-started.mdx
new file mode 100644
index 000000000..bd304e678
--- /dev/null
+++ b/src/routes/v2/(1)getting-started.mdx
@@ -0,0 +1,27 @@
+---
+title: Getting started
+titleTemplate: ":title"
+mainNavExclude: true
+---
+
+Use Solid CLI to create a new project:
+
+```package-create
+solid
+```
+
+You will be prompted to answer a few questions about your project.
+If you're unsure, stick with the default options.
+By default, the setup uses SolidStart, which is Solid's full-stack framework.
+
+## Alternatives to SolidStart
+
+While we strongly recommend using Solid with SolidStart, you can also use Solid directly with [Vite](https://vite.dev/) by selecting the `SolidJS + Vite` option in the Solid CLI.
+
+:::note
+Vite is commonly used for building [single-page applications (SPAs)](https://en.wikipedia.org/wiki/Single-page_application), which you can also build with [SolidStart](/solid-start).
+:::
+
+## Getting help
+
+If you need assistance, don't hesitate to ask for help in the [Discord chatroom](https://discord.com/invite/solidjs)!

From 71049b9a047975c4d9d7e1cb7d6734d39013b865 Mon Sep 17 00:00:00 2001
From: "Amir H. Hashemi" <87268103+amirhhashemi@users.noreply.github.com>
Date: Fri, 3 Jul 2026 17:25:45 +0330
Subject: [PATCH 2/2] add version

---
 src/routes/v2/(1)getting-started.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/routes/v2/(1)getting-started.mdx b/src/routes/v2/(1)getting-started.mdx
index bd304e678..425766cf3 100644
--- a/src/routes/v2/(1)getting-started.mdx
+++ b/src/routes/v2/(1)getting-started.mdx
@@ -2,6 +2,7 @@
 title: Getting started
 titleTemplate: ":title"
 mainNavExclude: true
+version: "2.0"
 ---
 
 Use Solid CLI to create a new project: