Enhance wording in readme

Author: abogoyavlensky

README.md

@@ -1,8 +1,7 @@
 # Full-stack Clojure/Script app with deployment using Kamal
 
-This project aims to show a setup of Clojure/Script web-application that
-uses PostgreSQL as a database. Also, there is a config for
-deployment the app with Kamal on **a single server**.
+This project demonstrates the setup of a Clojure/Script web application that uses PostgreSQL as its database.
+It also includes configuration for deploying the app with Kamal on **a single server**.
 
 Key backend libs:
 - Integrant
@@ -27,47 +26,49 @@ Other tools:
 
 ## The app
 
-It's a setup for Clojure/Script application with an example API route for getting 
-movies list and showing them on the main page.
+This setup provides a Clojure/Script web application with an example API route for fetching 
+a list of movies and displaying them on the main page.
+
+![App main page](/docs/app_page.png)
 
 ## Deploy: TL;DR
 
-First deploy: 
+First deployment: 
 
 ```shell
-./kamal.sh envify --skip-push  # then fill all variables in newly created .env file
+./kamal.sh envify --skip-push  # then fill all variables in the newly created `.env` file
 ./kamal.sh server bootstrap
 ssh [email protected] 'docker network create traefik'
 ssh [email protected] 'mkdir -p /root/letsencrypt && touch /root/letsencrypt/acme.json && chmod 600 /root/letsencrypt/acme.json'
 ./kamal.sh setup
 ./kamal.sh app exec 'java -jar standalone.jar migrations'
 ```
 
-Then any subsequent deploy from local machine:
+For subsequent deployments from the local machine:
 
 ```shell
 ./kamal.sh deploy
 ```
 
-or push to `master`-branch.
+or push to the master branch.
 
 ## Deploy: step-by-step
 
 ### Requirements
 
-Make sure you have Docker [installed](https://docs.docker.com/engine/install/) on your machine.
+Ensure you have Docker [installed](https://docs.docker.com/engine/install/) on your machine.
 
-We are going to use predefined command to run dockerized version of Kamal, 
-so in this case you don't need to install anything else to deploy your app.
+We will use a predefined command to run a dockerized version of Kamal,
+so you don’t need to install anything else to deploy your app.
 
 ```shell
 ./kamal.sh version
 ```
 
 ---
 
-:information_source: **Note**: _Alternatively you can install Kamal as ruby gem 
-and use just `kamal` command instead of dockerized version:_
+:information_source: **Note**: _Alternatively you can install Kamal as Ruby gem 
+and use the `kamal` command instead of dockerized version:_
 
 Install [mise-en-place](https://mise.jdx.dev/getting-started.html#quickstart) (or [asdf](https://asdf-vm.com/guide/getting-started.html)), 
 add `ruby 3.3.0` to `.tool-versions` file and run:
@@ -83,16 +84,17 @@ kamal version
 
 #### Setup environment variables
 
-Run command `envify` to create `.env` with all required empty variables: 
+Run command `envify` to create a `.env` with all required empty variables: 
 
 ```shell
 ./kamal.sh envify --skip-push
 ```
 
-_Parameter `--skip-push` is needed to do not push `.env`-file to server._
+_The `--skip-push` parameter prevents the `.env` file from being pushed to the server._
+
+Now, you can fill all environment variables in the .env file with actual values for deployment on the server.
+Here’s an example:
 
-Now, you can fill all env vars in `.env`-file with actual values for deployment on a server.
-Let's check an example:
 ```shell
 # Generated by kamal envify
 # DEPLOY
@@ -112,10 +114,10 @@ POSTGRES_PASSWORD=secret-db-password
 ```
 
 Notes:
-- `SERVER_IP` - the IP of the server you wnat to deploy tour app, you should be able to connect to it using ssh-keys.
-- `REGISTRY_USERNAME` and `REGISTRY_PASSWORD` - credentials for docker registry, in our case we are using `ghcr.io`, but it can be anything. 
+- `SERVER_IP` - the IP of the server you want to deploy your app, you should be able to connect to it using ssh-keys.
+- `REGISTRY_USERNAME` and `REGISTRY_PASSWORD` - credentials for docker registry, in our case we are using `ghcr.io`, but it can be any registry. 
 - `TRAEFIK_ACME_EMAIL` - email for register TLS-certificate with Let's Encrypt and Traefik.
-- `APP_DOMAIN` - domain of your app, should be configured to point out to `SERVER_IP`. 
+- `APP_DOMAIN` - domain of your app, should be configured to point to `SERVER_IP`. 
 - `clojure-kamal-example-db` - this is the name of the database container from accessories section of `deploy/config.yml` file.
 - We duplicated database credentials to set up database container and use `DATABASE_URL` in the app. 
 
@@ -129,37 +131,37 @@ Install Docker on a server:
 ./kamal.sh server bootstrap
 ```
 
-Create docker network to have access to database container from the app by container name
-and directory for Let's Encrypt certificates:
+Create a Docker network for access to the database container from the app by container name
+and a directory for Let’s Encrypt certificates:
 
 ```shell
 ssh [email protected] 'docker network create traefik'
 ssh [email protected] 'mkdir -p /root/letsencrypt && touch /root/letsencrypt/acme.json && chmod 600 /root/letsencrypt/acme.json'
 ```
 
-Set up Traefik, database, environment variables and run app on a server:
+Set up Traefik, the database, environment variables and run app on a server:
 
 ```shell
 ./kamal.sh setup
 ```
 
-The app is deployed on the server, but it is not fully functioning yet, we need to run database migrations:
+The app is deployed on the server, but it is not fully functional yet. You need to run database migrations:
 
 ```shell
 ./kamal.sh app exec 'java -jar standalone.jar migrations'
 ```
 
-Now, we the application fully deployed on the server.
+Now, the application is fully deployed on the server.
 
 ### Regular deploy
 
-Then, next time for deploy the app from local machine, run:
+For subsequent deployments from the local machine, run:
 
 ```shell
 ./kamal.sh deploy
 ```
 
-Or just push to the master, there is a GitHub Actions pipeline that does 
+Or just push to the master branch, there is a GitHub Actions pipeline that does 
 the deployment automatically `.github/workflows/deploy.yaml`.
 
 ### Setup CI for deployment