replace the "Get started with Exposed" tutorial with new content and …

…add sample project

docs/Map.jhm

@@ -1 +1 @@
-<?xml version='1.0' encoding='UTF-8'?><map version="2.0"><mapID target="Deep-Dive-into-DSL.md" url="deep-dive-into-dsl.html" default="no"/><mapID target="Frequently Asked Questions" url="frequently-asked-questions.html" default="no"/><mapID target="Deep-Dive-into-DSL" url="deep-dive-into-dsl.html" default="no"/><mapID target="Getting+Started+with+Exposed" url="getting-started-with-exposed.html" default="no"/><mapID target="Deep-Dive-into-DAO.md" url="deep-dive-into-dao.html" default="no"/><mapID target="Breaking+Changes" url="breaking-changes.html" default="no"/><mapID target="Breaking-Changes.md" url="breaking-changes.html" default="no"/><mapID target="Breaking-Changes" url="breaking-changes.html" default="no"/><mapID target="Exposed Documentation" url="home.html" default="no"/><mapID target="SQL-Functions" url="sql-functions.html" default="no"/><mapID target="Deep+Dive+into+DAO" url="deep-dive-into-dao.html" default="no"/><mapID target="Frequently+Asked+Questions" url="frequently-asked-questions.html" default="no"/><mapID target="Home.topic" url="home.html" default="yes"/><mapID target="SQL+Functions" url="sql-functions.html" default="no"/><mapID target="Breaking Changes" url="breaking-changes.html" default="no"/><mapID target="Deep Dive into DAO" url="deep-dive-into-dao.html" default="no"/><mapID target="Migration-Guide.md" url="migration-guide.html" default="no"/><mapID target="Exposed Modules" url="exposed-modules.html" default="no"/><mapID target="Data Types" url="data-types.html" default="no"/><mapID target="Transactions" url="transactions.html" default="no"/><mapID target="Data+Types" url="data-types.html" default="no"/><mapID target="Samples" url="samples.html" default="no"/><mapID target="Exposed-Modules.md" url="exposed-modules.html" default="no"/><mapID target="Database-and-DataSource.md" url="database-and-datasource.html" default="no"/><mapID target="Exposed+Documentation" url="home.html" default="no"/><mapID target="Migration-Guide" url="migration-guide.html" default="no"/><mapID target="Exposed-Modules" url="exposed-modules.html" default="no"/><mapID target="Data-Types" url="data-types.html" default="no"/><mapID target="Frequently-Asked-Questions" url="frequently-asked-questions.html" default="no"/><mapID target="Getting Started with Exposed" url="getting-started-with-exposed.html" default="no"/><mapID target="Deep+Dive+into+DSL" url="deep-dive-into-dsl.html" default="no"/><mapID target="Contributing" url="contributing.html" default="no"/><mapID target="Exposed+Modules" url="exposed-modules.html" default="no"/><mapID target="Contributing to Exposed" url="contributing.html" default="no"/><mapID target="Contributing.md" url="contributing.html" default="no"/><mapID target="Database-and-DataSource" url="database-and-datasource.html" default="no"/><mapID target="Deep-Dive-into-DAO" url="deep-dive-into-dao.html" default="no"/><mapID target="Transactions.md" url="transactions.html" default="no"/><mapID target="Deep Dive into DSL" url="deep-dive-into-dsl.html" default="no"/><mapID target="Samples.md" url="samples.html" default="no"/><mapID target="Getting-Started-with-Exposed.md" url="getting-started-with-exposed.html" default="no"/><mapID target="Working+with+Database+and+DataSource" url="database-and-datasource.html" default="no"/><mapID target="Home" url="home.html" default="yes"/><mapID target="SQL Functions" url="sql-functions.html" default="no"/><mapID target="Data-Types.md" url="data-types.html" default="no"/><mapID target="Migration+Guide" url="migration-guide.html" default="no"/><mapID target="Working with Database and DataSource" url="database-and-datasource.html" default="no"/><mapID target="Contributing+to+Exposed" url="contributing.html" default="no"/><mapID target="SQL-Functions.md" url="sql-functions.html" default="no"/><mapID target="Getting-Started-with-Exposed" url="getting-started-with-exposed.html" default="no"/><mapID target="-of4r3s_1_json" url="starting-page-Home.json" default="no"/><mapID target="Frequently-Asked-Questions.md" url="frequently-asked-questions.html" default="no"/><mapID target="Migration Guide" url="migration-guide.html" default="no"/></map>
+<?xml version='1.0' encoding='UTF-8'?><map version="2.0"><mapID target="Deep-Dive-into-DSL.md" url="deep-dive-into-dsl.html" default="no"/><mapID target="Frequently Asked Questions" url="frequently-asked-questions.html" default="no"/><mapID target="Deep-Dive-into-DSL" url="deep-dive-into-dsl.html" default="no"/><mapID target="Getting+Started+with+Exposed" url="getting-started-with-exposed.html" default="no"/><mapID target="Deep-Dive-into-DAO.md" url="deep-dive-into-dao.html" default="no"/><mapID target="Breaking+Changes" url="breaking-changes.html" default="no"/><mapID target="Breaking-Changes.md" url="breaking-changes.html" default="no"/><mapID target="Breaking-Changes" url="breaking-changes.html" default="no"/><mapID target="Exposed Documentation" url="home.html" default="no"/><mapID target="SQL-Functions" url="sql-functions.html" default="no"/><mapID target="Deep+Dive+into+DAO" url="deep-dive-into-dao.html" default="no"/><mapID target="Frequently+Asked+Questions" url="frequently-asked-questions.html" default="no"/><mapID target="Home.topic" url="home.html" default="yes"/><mapID target="SQL+Functions" url="sql-functions.html" default="no"/><mapID target="Breaking Changes" url="breaking-changes.html" default="no"/><mapID target="Deep Dive into DAO" url="deep-dive-into-dao.html" default="no"/><mapID target="Migration-Guide.md" url="migration-guide.html" default="no"/><mapID target="Exposed Modules" url="exposed-modules.html" default="no"/><mapID target="Data Types" url="data-types.html" default="no"/><mapID target="Transactions" url="transactions.html" default="no"/><mapID target="Data+Types" url="data-types.html" default="no"/><mapID target="Samples" url="samples.html" default="no"/><mapID target="Exposed-Modules.md" url="exposed-modules.html" default="no"/><mapID target="Database-and-DataSource.md" url="database-and-datasource.html" default="no"/><mapID target="Exposed+Documentation" url="home.html" default="no"/><mapID target="Migration-Guide" url="migration-guide.html" default="no"/><mapID target="Exposed-Modules" url="exposed-modules.html" default="no"/><mapID target="Data-Types" url="data-types.html" default="no"/><mapID target="Frequently-Asked-Questions" url="frequently-asked-questions.html" default="no"/><mapID target="Getting Started with Exposed" url="getting-started-with-exposed.html" default="no"/><mapID target="Deep+Dive+into+DSL" url="deep-dive-into-dsl.html" default="no"/><mapID target="Contributing" url="contributing.html" default="no"/><mapID target="Exposed+Modules" url="exposed-modules.html" default="no"/><mapID target="Contributing to Exposed" url="contributing.html" default="no"/><mapID target="Contributing.md" url="contributing.html" default="no"/><mapID target="Database-and-DataSource" url="database-and-datasource.html" default="no"/><mapID target="Deep-Dive-into-DAO" url="deep-dive-into-dao.html" default="no"/><mapID target="Transactions.md" url="transactions.html" default="no"/><mapID target="Deep Dive into DSL" url="deep-dive-into-dsl.html" default="no"/><mapID target="Samples.md" url="samples.html" default="no"/><mapID target="Getting-Started-with-Exposed.topic" url="getting-started-with-exposed.html" default="no"/><mapID target="Working+with+Database+and+DataSource" url="database-and-datasource.html" default="no"/><mapID target="Home" url="home.html" default="yes"/><mapID target="SQL Functions" url="sql-functions.html" default="no"/><mapID target="Data-Types.md" url="data-types.html" default="no"/><mapID target="Migration+Guide" url="migration-guide.html" default="no"/><mapID target="Working with Database and DataSource" url="database-and-datasource.html" default="no"/><mapID target="Contributing+to+Exposed" url="contributing.html" default="no"/><mapID target="SQL-Functions.md" url="sql-functions.html" default="no"/><mapID target="Getting-Started-with-Exposed" url="getting-started-with-exposed.html" default="no"/><mapID target="-of4r3s_1_json" url="starting-page-Home.json" default="no"/><mapID target="Frequently-Asked-Questions.md" url="frequently-asked-questions.html" default="no"/><mapID target="Migration Guide" url="migration-guide.html" default="no"/></map>

documentation-website/Writerside/hi.tree

@@ -7,7 +7,7 @@
                   start-page="Home.topic">
 
     <toc-element topic="Home.topic"/>
-    <toc-element topic="Getting-Started-with-Exposed.md"/>
+    <toc-element topic="Getting-Started-with-Exposed.topic"/>
     <toc-element topic="Database-and-DataSource.md"/>
     <toc-element topic="Transactions.md"/>
     <toc-element topic="Deep-Dive-into-DSL.md"/>

documentation-website/Writerside/snippets/get-started-with-exposed/.gitattributes

@@ -0,0 +1,9 @@
+#
+# https://help.github.com/articles/dealing-with-line-endings/
+#
+# Linux start script should use lf
+/gradlew        text eol=lf
+
+# These are Windows script files and should use crlf
+*.bat           text eol=crlf
+

documentation-website/Writerside/snippets/get-started-with-exposed/.gitignore

@@ -0,0 +1,5 @@
+# Ignore Gradle project-specific cache directory
+.gradle
+
+# Ignore Gradle build output directory
+build

documentation-website/Writerside/snippets/get-started-with-exposed/README.md

@@ -0,0 +1,12 @@
+# Get started with Exposed tutorial project
+
+A sample Gradle/Kotlin project built by following the steps explained in
+the [Get started with Exposed](https://jetbrains.github.io/Exposed/getting-started-with-exposed.html) tutorial.
+
+## Run
+
+To run the application, execute the following command in the repository's root directory:
+
+```bash
+./gradlew run
+```

documentation-website/Writerside/snippets/get-started-with-exposed/app/build.gradle.kts

@@ -0,0 +1,52 @@
+/*
+ * This file was generated by the Gradle 'init' task.
+ *
+ * This generated file contains a sample Kotlin application project to get you started.
+ * For more details on building Java & JVM projects, please refer to https://docs.gradle.org/8.8/userguide/building_java_projects.html in the Gradle documentation.
+ */
+
+plugins {
+    // Apply the org.jetbrains.kotlin.jvm Plugin to add support for Kotlin.
+    alias(libs.plugins.jvm)
+
+    // Apply the application plugin to add support for building a CLI application in Java.
+    application
+}
+
+repositories {
+    // Use Maven Central for resolving dependencies.
+    mavenCentral()
+}
+
+dependencies {
+    // Use the Kotlin JUnit 5 integration.
+    testImplementation("org.jetbrains.kotlin:kotlin-test-junit5")
+
+    // Use the JUnit 5 integration.
+    testImplementation(libs.junit.jupiter.engine)
+
+    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
+
+    // This dependency is used by the application.
+    implementation(libs.guava)
+    implementation(libs.exposed.core)
+    implementation(libs.exposed.jdbc)
+    implementation("com.h2database:h2:1.4.200")
+}
+
+// Apply a specific Java toolchain to ease working on different environments.
+java {
+    toolchain {
+        languageVersion = JavaLanguageVersion.of(21)
+    }
+}
+
+application {
+    // Define the main class for the application.
+    mainClass = "org.example.AppKt"
+}
+
+tasks.named<Test>("test") {
+    // Use JUnit Platform for unit tests.
+    useJUnitPlatform()
+}