Improving Documentation: Fixing Name Convetions and Formatting (#576)

* Small title nitpick fixes and using JetBrains MonoSpace code font

* Small grammar fixes and improvements

* fix entry gen entries

* standardize file names using kebab case

* fix name casing

* fix link in index page

* revamps 'settin-up' page

* switch to kotlin-ish theme color

Author: gabryon99

README.md

@@ -1,33 +1,53 @@
-# Godot Kotlin JVM
-
-# Kotlin/JVM binding for the Godot Game Engine
+# Godot Kotlin/JVM
+## Kotlin/JVM binding for the Godot Game Engine
 
 <p align="center">
 <img src=".README/logo.png" width="30%" height="30%">
 </p>
 
 ## Overview
 
-This is a **Kotlin** language binding for the [**Godot**](https://godotengine.org/) game engine. It is built as a module (like the C# binding) to interact with **Godot**'s core internally. The binding provides you Godot API's as Kotlin classes, so you can write your game logic completely in Kotlin. Your code will be compiled into a .jar which is then executed by an embedded JVM, so you don't have to worry that your users have Java installed. It's already embedded in your game executable.
-You also don't have to worry about any binding logic. Just write your game scripts like you would for [GDScript](https://docs.godotengine.org/en/3.1/getting_started/scripting/gdscript/gdscript_basics.html) or [C#](https://docs.godotengine.org/en/3.1/getting_started/scripting/c_sharp/) but with all the syntactic sugar of Kotlin.
+This is a [**Kotlin**](https://kotlinlang.org) language binding for the [**Godot**](https://godotengine.org/) game engine.
+It is built as a module (like the C# binding) to interact with **Godot**'s core internally.
+
+The binding provides you Godot API's as [Kotlin classes](https://godot-kotl.in/en/stable/getting-started/your-first-class/),
+so you can write your game logic completely in Kotlin.
+
+### Code Distribution
+
+There are two methods for distributing JVM bytecode produced by the Kotlin compiler:
+
+1.  A classic JAR file: your code will be packed into a `.jar` file, which is then executed by an embedded JVM.
+    So the developer does not have to worry about their user installing a JRE. The JVM is already embedded in your game executable.
+2.  Dynamic Library using GraalVM Native Image: please read more about this in our [documentation page](https://godot-kotl.in/en/stable/user-guide/advanced/graal-vm-native-image/).
+
+Just write your game scripts like you would for [GDScript](https://docs.godotengine.org/en/4.2/getting_started/scripting/gdscript/gdscript_basics.html)
+or for [C#](https://docs.godotengine.org/en/3.1/getting_started/scripting/c_sharp/) but with all the syntactic sugar of Kotlin.
 
 [![GitHub](https://img.shields.io/github/license/utopia-rise/godot-kotlin-jvm?style=flat-square)](LICENSE)
 
-## Important notes
+## Important Notes
 
-This version of the binding is currently **Alpha**!  
+This version of the binding is currently **Alpha**! This means that the bindings are not
+production-ready. However, if you are curious in using Kotlin in Godot, this is a good opportunity
+to help us in improving the project!
 
 ## Documentation
-The documentation can be found [here](https://godot-kotl.in)
 
-## Developer discussion
+The documentation can be found [here](https://godot-kotl.in). It's a work in progress, and we would love your input to
+make it even better!
+
+## Developer Discussion & Contribution
 
-Ask questions and collaborate on [Discord](https://discord.gg/zpb5Ru7v9x)
+Join us on our [Discord](https://discord.gg/zpb5Ru7v9x) server to ask questions and work together
+with a friendly community.
 
-## Contribution
-If you want to contribute to the project, please read through the contribution guidlines and getting started sections [here](https://godot-kotl.in/en/stable/contribution/guidelines/)
+If you want to contribute to the project, please read through the [contribution guidelines](https://godot-kotl.in/en/stable/contribution/guidelines/)
+and the [setup](https://godot-kotl.in/en/stable/contribution/setup/) sections.
 
 ## Partners
-Jetbrains is helping us to develop this project by providing development tools to maintainers.  
-Intellij IDEA is our IDE of choice for Kotlin development and we strongly recommend using it.  
+
+JetBrains is helping us to develop this project by providing development tools to maintainers.
+Intellij IDEA is our IDE of choice for Kotlin development and we strongly recommend using it.
+
 [![jblogo](.README/jetbrains.svg)](https://www.jetbrains.com/)

docs/mkdocs.yml

@@ -8,15 +8,26 @@ theme:
   name: material
   favicon: assets/img/favicon.ico
   palette:
-    - scheme: default
+    - media: "(prefers-color-scheme)"
+      primary: deep purple
       toggle:
-        icon: material/toggle-switch-off-outline
+        icon: material/brightness-auto
+        name: Switch to light mode
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: deep purple
+      toggle:
+        icon: material/brightness-7
         name: Switch to dark mode
-    - scheme: slate
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: deep purple
       toggle:
-        icon: material/toggle-switch
-        name: Switch to light mode
+        icon: material/brightness-4
+        name: Switch to system preference
   logo: assets/img/logo.png
+  font:
+    code: JetBrains Mono
   features:
     - navigation.tabs
     - navigation.expand
@@ -35,6 +46,7 @@ markdown_extensions:
   - pymdownx.highlight
   - pymdownx.superfences
   - pymdownx.tabbed
+  - pymdownx.details
   - admonition
   - meta
 
@@ -46,10 +58,10 @@ extra_css:
 
 nav:
   - Home: index.md
-  - Getting started:
+  - Getting Started:
       - Requirements: getting-started/requirements.md
-      - Setting up: getting-started/setting-up.md
-      - Your first class: getting-started/your-first-class.md
+      - Setting-up: getting-started/setting-up.md
+      - Your first Kotlin class: getting-started/your-first-class.md
   - User guide:
     - API differences: user-guide/api-differences.md
     - Classes: user-guide/classes.md
@@ -63,13 +75,13 @@ nav:
     - Versioning: user-guide/versioning.md
     - Supported platforms: user-guide/supported-platforms.md
     - Advanced:
-      - Abstract Classes: user-guide/advanced/abstract_classes.md
-      - Custom src dirs: user-guide/advanced/custom-src-dirs.md
-      - Custom gradle wrapper path: user-guide/advanced/custom_gradle_wrapper_path.md
+      - Abstract classes: user-guide/advanced/abstract-classes.md
+      - Custom source directories: user-guide/advanced/custom-src-dirs.md
+      - Custom gradle wrapper path: user-guide/advanced/custom-gradle-wrapper-path.md
       - Gradle plugin configuration: user-guide/advanced/gradle-plugin-configuration.md
-      - Commandline args: user-guide/advanced/commandline-args.md
+      - Command-line arguments: user-guide/advanced/commandline-args.md
       - Kotlin singletons: user-guide/advanced/kotlin-singleton.md
-      - GraalVM native-image: user-guide/advanced/graal-vm-native-image.md
+      - GraalVM Native Image: user-guide/advanced/graal-vm-native-image.md
   - Develop libraries:
       - Introduction: develop-libraries/introduction.md
       - Setup: develop-libraries/setup.md
@@ -79,9 +91,9 @@ nav:
     - Guidelines: contribution/guidelines.md
     - Setup: contribution/setup.md
     - Build with C# support: contribution/build-with-csharp-support.md
-    - Support for other jvm based languages: contribution/support_for_other_jvm_based_languages.md
+    - Support for other JVM-based languages: contribution/support-for-other-jvm-based-languages.md
     - Knowledge base:
         - Artefact differentiation: contribution/knowledge-base/artefact-differentiation.md
         - Entry generation: contribution/knowledge-base/entry-generation.md
         - Shared buffer: contribution/knowledge-base/shared-buffer.md
-        - Memory Management: contribution/knowledge-base/memory-management.md
+        - Memory management: contribution/knowledge-base/memory-management.md