Docs Tweaks and Improvements

docs/01-Getting-Started/1-Introduction.md

@@ -1,10 +1,38 @@
-From **development** to **production**, **kool** brings speed and security to software developers working with multiple tech stacks, making their development environments reproducible and easy to set up.
+# What is kool?
 
-**kool** will help you:
+**kool** is a powerful CLI tool designed to streamline the complexities of modern software development environments. It simplifies the use of Docker for local development, making environments lightweight, fast, and reproducible. And when you are ready, it will help you ship any `docker-compose.yml` based app to the cloud with
+an amazing Developer Experience.
 
-* Stop installing different tech stacks on your local machine (e.g. PHP/Ruby/Python, MySQL/MariaDB/PostgreSQL/MongoDB, NGINX/Apache, Redis/Memcached, Node, etc)
-* Stop writing how-to documentation for setting up local development environments
-* Eliminate "it works on my machine" problems caused by different versions / setups
-* Maintain total control of each tech stack on every project
-* Work locally using the very same tech stack and versions as your production environment
-* Work the same way across different tech stacks and projects (e.g. Laravel, Symfony, Next.js, Nuxt.js, AdonisJs, NestJS, Hugo, WordPress, etc)
+# Why would I want to use kool?
+
+Using **kool** offers several advantages:
+
+- **Easier Configuration:** Say goodbye to the learning curve and frustration of configuring Docker flags, fixing user permissions, and managing local and global networks.
+
+- **Simpler Containerization:** **kool** reduces the cognitive overhead of containerizing your stack with an intuitive CLI interface for managing Docker containers and Docker Compose services. Leverage battle-tested presets and configurations so you don't reinvent the wheel everytime.
+
+- **Faster Workflow:** Enjoy the speed of spinning up new local environments, effortlessly switching between projects, sharing local changes with colleagues and clients, and deploying to the cloud—all accomplished in seconds. Collect on the benefits of containers technology like Docker today without the steep leaning curve to do it the right way.
+
+- **Optimized Development:** **kool** provides custom Docker images optimized for local development and deployment. It also includes pre-built Presets with sensible defaults for rapid project setup using popular frameworks.
+
+# Who is kool for?
+
+**kool** caters to a broad audience, making it suitable for:
+
+- **Solo Developers:** Perfect for individual developers seeking a hassle-free way to handle Docker basics and immediately start using containers for development. From newcomers to senior DevOps, it's a friendly tool to anyone that enjoys and values good Developer Experience.
+
+- **Teams of All Sizes:** Ideal for teams, offering a unified approach to Docker while ensuring no loss of control over more specialized Docker environments. Making part of your DevOps needs a no brainer.
+
+# How to get started?
+
+Getting started with **kool** is straightforward:
+
+1. **Installation:** Ensure you have Docker installed and then follow the [installation instructions](/docs/01-Getting-Started/2-Installation.md) to set up **kool**.
+
+2. **Start new Local Environment:** Explore the [Starting new Project](/docs/01-Getting-Started/4-Starting-new-project.md) for a spinning up local environments to kickstart your development journey with **kool**.
+
+3. **Explore Presets:** Check out available [Presets](/docs/03-Presets/0-About-Presets.md) tailored for popular stacks and frameworks, providing a head start for your real-world applications.
+
+4. **Deployment to the Cloud:** Check out [Kool.dev Cloud](https://kool.dev/cloud) to elevate your Developer Experience to new highs - start deploying containerized apps the way you always dreamed should be possible.
+
+Now you're ready to experience a better, more efficient development environment with **kool**!

docs/01-Getting-Started/2-Installation.md

@@ -1,30 +1,30 @@
-## Installation
+# Installation
 
-### Requirements
+## Requirements
 
 **kool** is powered by **Docker**. To use **kool**, you need to **[install the Docker Engine and Docker Compose](https://docs.docker.com/get-docker/)** on your local machine, and make sure they're both running.
 
 Important to notice: `kool` relies on the `docker` and `docker compose` CLI commands - that being said, you can pick any other Docker-compatibable container engine and use it seamlessly, like OrbStack for example.
 
 > `kool` now requires [Docker Compose V2](https://docs.docker.com/compose/install/), make sure you have it enabled in your system.
 
-### For Linux and macOS
+## For Linux and macOS
 
 Install **kool** by running the following script. It will download the latest **kool** binary from [https://github.com/kool-dev/kool/releases](https://github.com/kool-dev/kool/releases), and save it in your `/usr/local/bin` folder.
 
 ```bash
 $ curl -fsSL https://kool.dev/install | bash
 ```
 
-### For Windows
+## For Windows
 
 You must run `kool` on Windows via [WSL - Windows Subsystem for Linux](https://learn.microsoft.com/en-us/windows/wsl/install) - once you have a WSL environment properly set up, make sure you have [Docker available on it](https://docs.docker.com/desktop/wsl/), then you can install the CLI as you would in any Linux or MacOS (see above).
 
 ### Verification
 
 Verify **kool** is installed correctly by running `kool` in your terminal to see a list of available commands.
 
-## Stay Up-to-Date
+# Stay Up-to-Date
 
 Update **kool** to a newer version using the `self-update` command. This command will compare your local version with the latest release, and, if a newer version is available, automatically download and install it.
 
@@ -34,11 +34,11 @@ $ kool self-update
 
 > Sign up for new release notifications and stay up-to-date on our latest features! [Go to our main GitHub repository](https://github.com/kool-dev/kool), click on "Watch" at the top, select the "Custom" option, check "Releases", and hit Apply.
 
-## Autocompletion
+# Autocompletion
 
 If you want to use **kool** autocompletion in your Unix shell, follow the appropriate instructions below.
 
-### Bash
+## Bash
 
 Temporarily enable autocompletion for your **current session only**:
 
@@ -62,7 +62,7 @@ $ kool completion bash > /usr/local/etc/bash_completion.d/kool
 
 > After running one of the above commands, remember to start a new shell for autocompletion to take effect.
 
-### Zsh
+## Zsh
 
 If Zsh tab completion is not already initialized on your machine, run the following command to turn it on.
 
@@ -78,7 +78,7 @@ $ kool completion zsh > "${fpath[1]}/_kool"
 
 > After running the above command, remember to start a new shell for autocompletion to take effect.
 
-### Fish
+## Fish
 
 Temporarily enable autocompletion for your **current session only**:
 

docs/03-Presets/0-About-Presets.md

@@ -0,0 +1,32 @@
+# Kool Presets: Streamlining Your Development Experience
+
+Kool Presets are curated configurations tailored to popular stacks and frameworks, designed to jumpstart your projects with efficiency and ease. Whether you're working with Node.js, PHP, JavaScript, or other technologies, Kool Presets provide battle-tested configurations, saving you from the hassle of reinventing the wheel for each new project.
+
+These presets encapsulate best practices, allowing you to focus on your code rather than spending time on intricate setup processes. From popular backend frameworks like Laravel and NestJS to frontend powerhouses like Next.js and NuxtJS, Kool Presets cover a spectrum of technologies, offering you a head start in building robust and scalable applications.
+
+By leveraging Kool Presets, you not only reduce the learning curve associated with configuring different environments but also ensure consistency across your projects. With Kool, enjoy a unified and efficient development experience, whether you're a solo developer seeking a quick setup or a team collaborating on complex projects. Explore the available presets and elevate your development workflow with Kool Presets today.
+
+# Popular Presets
+
+## Node
+
+- [NestJS](docs/03-Presets/NestJS.md)
+- [AdonisJs](docs/03-Presets/AdonisJs.md)
+- [Express.js](/docs/03-Presets/ExpressJS.md)
+
+## PHP
+
+- [Laravel](/docs/03-Presets/Laravel.md)
+- [Laravel Octane](/docs/03-Presets/Laravel+Octane.md)
+- [Symfony](/docs/03-Presets/Symfony.md)
+- [CodeIgniter](/docs/03-Presets/CodeIgniter.md)
+
+## Javascript
+
+- [Next.js](/docs/03-Presets/NextJS.md)
+- [NuxtJS](/docs/03-Presets/NuxtJS.md)
+
+## Others
+
+- [Hugo](/docs/03-Presets/Hugo.md)
+- [WordPress](/docs/03-Presets/WordPress.md)