Updated README

Author: Vadym Mudryi

README.md

@@ -1,35 +1,45 @@
-# !!! Work in progress
+# 🚧 Work in Progress
 
-Not all features available in docker swarm solution are supported now.
+Please note that not all features from the Docker Swarm solution are supported yet.
 
-Limitations:
-- Only manual helm installation and upgrade
-- Manual initial users configuration for minio, mongodb, elastic search
-- No data reset feature
+### Limitations:
+- Manual Helm installation and upgrade only
+- Manual initial user configuration for MinIO, MongoDB, Elasticsearch
+- No data reset feature available
 
-# General information
+---
 
-Repository to store infrastructure code for OpenCRVS deployment
+## General Information
 
+This repository is used to store infrastructure code for deploying OpenCRVS.
+
+---
 
 # OpenCRVS on Kubernetes
 
-## Kubernetes cluster Prerequisites
+## Prerequisites for Kubernetes Cluster
 
 ### Storage
 
-Storage class with encryption or respective encryption is implemented at filesystem level:
-- For existing OpenCRVS installations make sure cluster has at least `hostpath` storage class configured and directories on file system are pointed to encrypted partitions. `hostpath` is the best option for drop-in replacement docker swarm to kubernetes, data will not be touched in that case. Later data can be migrated to more robust storage, e/g `local` or `nfs` volumes.
-- For new installations please check available options at official documentation [[1]](https://kubernetes.io/docs/concepts/storage/volumes/), [[2]](https://kubernetes.io/docs/concepts/storage/storage-classes/#provisioner). Recommended storage class for new installations is NFS.
+Ensure your cluster has a storage class with encryption, or encryption is implemented at the filesystem level:
 
-Please also check all available options for CSI at: https://github.com/kubernetes-csi/
+- **For existing OpenCRVS installations:**
+  Make sure the cluster has at least the `hostpath` storage class configured and directories on the filesystem should point to encrypted partitions.
+  `hostpath` is the best option for migration from Docker Swarm to Kubernetes; it allows data to remain untouched. Data can be migrated to more robust storage later, such as `local` or `nfs` volumes after OpenCRVS migration to Kubernetes.
 
-**NOTE:** Depending on available hardware resources it is also possible to optimize installation by splitting data into different types of volumes, e/g `hostpath` works better for Elasticsearch, while `NFS` is best option for `minio` and `mongo` (`postgres`)
+- **For new installations:**
+  - Please check the available storage options in the official documentation: [Kubernetes Volumes Documentation](https://kubernetes.io/docs/concepts/storage/volumes/) and [Kubernetes Storage Classes Documentation](https://kubernetes.io/docs/concepts/storage/storage-classes/#provisioner).
+  - The recommended storage class for new installations is NFS.
 
+Additionally, explore all possible options for CSI (Container Storage Interface) at the [CSI GitHub repository](https://github.com/kubernetes-csi/).
 
+**NOTE:** Depending on your available hardware resources, you may optimize the installation by splitting data across different types of volumes. For example:
+- `Hostpath` works better for Elasticsearch.
+- `NFS` is the best option for MinIO and Mongo (or Postgres).
 
-# Links
+---
 
-[1] https://kubernetes.io/docs/concepts/storage/volumes/
+# Useful Links
 
-[2] https://kubernetes.io/docs/concepts/storage/storage-classes/#provisioner
+- [Kubernetes Volumes Documentation](https://kubernetes.io/docs/concepts/storage/volumes/)
+- [Kubernetes Storage Classes Documentation](https://kubernetes.io/docs/concepts/storage/storage-classes/#provisioner)