From e1adc4c95db01794a6e33af111874ecdd36505d3 Mon Sep 17 00:00:00 2001
From: Cake <65981767+CakeVR@users.noreply.github.com>
Date: Sun, 10 Dec 2023 10:21:24 +0100
Subject: [PATCH] Restore and update the introduction.

---
 documentation/introduction.md | 50 ++++++++++++++++++++++++++++++++++-
 1 file changed, 49 insertions(+), 1 deletion(-)

diff --git a/documentation/introduction.md b/documentation/introduction.md
index bad5562..9566d41 100644
--- a/documentation/introduction.md
+++ b/documentation/introduction.md
@@ -1 +1,49 @@
-# Getting Started
+
+# Introduction to Dialogic 2
+
+```admonish info
+This documentation is for Dialogic 2. 
+
+Dialogic 2 is still in-development and marked as Alpha, there may be workflow breakage!
+```
+
+## What is Dialogic 2?
+
+The Dialogic plugin allows you to easily create in-game dialogs or fully fledged **Visual Novels** with Godot. 
+
+Dialogic 2 empowers you with:
+
+**Timelines**! They control the flow of your story. They can be edited in a writer-friendly **Visual Editor** or your editor of choice.
+2. **Events**! Each timeline contains events, and Dialogic equips you with many built-ones to get your story started today!
+
+3. **Customization!** Cannot find the right Event? Find out what others created, or create your own specific Events with very little code. They flow right into the Visual Editor too!
+
+4. **Character system and editor** that allows you to easily create characters with the images you desire ("portraits").
+
+This is just scratching the surface of what's possible. 
+Here is a small list of other things you can do:
+
+
+- [Create events and timelines in code](/documentation/creating-timelines-in-code)
+
+- Use built-in "text actions" like `[speed]`, `[pause]`, `[signal]`, `[portrait]`
+
+- Easy-to-use variables in your timelines!
+
+- Create a glossary with strings that can be hovered over to show information.
+
+- Translate characters and timelines with the integrated CSV file system!
+
+- Easily create custom events; they are all resources.
+
+- Access functionality from code, for instance, "Dialogic.Portraits.change_portrait(Emilio, "happy")`, `Dialogic.Backgrounds.update_background("res://icon.png")`
+
+## How do I get started?
+
+[Let's get started](getting-started), there are numerous pages in this documentation, and more are coming!
+
+## Can I upgrade my current game made using Dialogic 1?
+
+There are several things to overcome when upgrading from Dialogic 1. First, Dialogic 1 is exclusively for Godot 3, while Dialogic 2 is made for Godot 4. That means that you first need to make sure that your project works in Godot 4 by making the necessary adjustments.
+
+If you have already made a lot of progress in your game, there is no reason to upgrade. We recommend you stick to Godot 3 and Dialogic 1. But if you want to give it a try, thanks to our contributors, there is a Dialogic 1 to Dialogic 2 converter available.