docs: improve README.md fmt, wording and phrasing

Author: fdnt7

README.md

@@ -4,116 +4,126 @@
 
 # Λύρα
 
-[![Build status](https://github.com/lyra-music/lyra/actions/workflows/ci.yml/badge.svg?branch=main&event=push)](https://github.com/lyra-music/lyra/actions/workflows/ci.yml)
-[![GitHub release](https://img.shields.io/github/release/lyra-music/lyra.svg)](https://github.com/lyra-music/lyra/releases/latest)
-[![dev chat](https://discordapp.com/api/guilds/1033430025527103568/widget.png?style=shield)](https://discord.gg/d4UerJpvTp)
-[![CodeFactor](https://www.codefactor.io/repository/github/lyra-music/lyra/badge)](https://www.codefactor.io/repository/github/lyra-music/lyra)
+[![Built with Nix](https://img.shields.io/static/v1?logo=nixos&logoColor=white&label=&message=Built%20with%20Nix&color=41439a)](https://builtwithnix.org)
+[![Community Chat](https://discordapp.com/api/guilds/1033430025527103568/widget.png?style=shield)](https://discord.gg/d4UerJpvTp)
+[![Code Quality](https://www.codefactor.io/repository/github/lyra-music/lyra/badge)](https://www.codefactor.io/repository/github/lyra-music/lyra)
+[![Build Status](https://github.com/lyra-music/lyra/actions/workflows/ci.yml/badge.svg?branch=main&event=push)](https://github.com/lyra-music/lyra/actions/workflows/ci.yml)
+[![Latest Release](https://img.shields.io/github/release/lyra-music/lyra.svg)](https://github.com/lyra-music/lyra/releases/latest)
+![License](https://img.shields.io/github/license/lyra-music/lyra)
 
 A *self-hostable* **Discord music bot**, focused on *fairness*.
 
 > [!NOTE]
-> This project is actively developed with a focus on maintaining stability.
-> Users are encouraged to self-host and test the bot locally.
-> Core functionality is implemented, though some features like queue viewing and polling systems for command fairness are still in development.
+> Λύρα is actively developed with a strong focus on maintaining stability.
+> Core functionality is fully implemented, but some features (e.g., queue visualisation, command fairness polls) are still under development.
+> Users are encouraged to self-host and test locally.
+
+---
 
 ## Setup
 
-Start by copying the example environment file:
+Start by creating your environment configuration:
 
 ```console
 $ cp .env.example .env
 ```
 
-Then, edit the `.env` file to set your environment variables. The file contains comments to guide you. At a minimum you should provide a valid `BOT_TOKEN`, database credentials, and lavalink credentials.
+Edit `.env` and provide the required values:
+- `BOT_TOKEN` (Discord bot token)
+- Database credentials
+- Lavalink credentials
+
+Comments in the file will guide you through the configuration.
+
+---
 
-### Docker
+### Running
 
-The easiest way to set up Λύρα is to use Docker. Start by creating a copy of the example docker compose file:
+The easiest way to run Λύρα is via Docker. Begin by copying the example Compose file:
 
 ```console
 $ cp compose.example.yaml compose.yaml
 ```
 
-In addition, you need to set `DOCKER_POSTGRES_PATH` and `DOCKER_LAVALINK_PLUGINS_PATH` environment variables in `.env` to point to two empty directories you want to use for the database and plugins respectively. You can create them with:
+Next, set up two directories for persistent storage (PostgreSQL data and Lavalink plugins) and update your `.env`:
 
 ```console
 $ mkdir -p /path/to/your/database
 $ mkdir -p /path/to/your/plugins
 # chown -R 322:322 /path/to/your/plugins
 ```
 
+Update `.env`:
+
 ```dotenv
-# File: .env
 DOCKER_POSTGRES_PATH=/path/to/your/database
 DOCKER_LAVALINK_PLUGINS_PATH=/path/to/your/plugins
 ```
 
-Then, run the following command to start the bot and the database:
+Start the bot and services:
 
 ```console
 # docker compose up -d
 ```
-This will start the bot and its associated services in detached mode and run them in the background. To check the logs, run:
 
-```console
-# docker compose logs -f
-```
+- View logs:
+  ```console
+  # docker compose logs -f
+  ```
+- Stop services:
+  ```console
+  # docker compose down
+  ```
 
-To stop the bot, run:
+---
 
-```console
-# docker compose down
-```
-
-### Nix (For Development)
+### Development
 
-Start by entering the development shell:
+If you're using [`nix-direnv`](https://github.com/nix-community/nix-direnv), enter the dev shell automatically; otherwise, run:
 
 ```console
-$ nix develop --impure
+$ nix develop --no-pure-eval
 ```
 
-This will also download all the dependencies and set up the environment. To start the services required for the bot to function, run:
+This sets up all dependencies. Then, start the required services:
 
 ```console
 $ devenv up -D
 ```
 
-To check the logs, run:
-```console
-$ process-compose attach
-```
+- Attach to logs:
+  ```console
+  $ process-compose attach
+  ```
+- Stop services:
+  ```console
+  $ process-compose down
+  ```
+- Run the bot:
+  ```console
+  $ cargo run --release
+  ```
 
-To stop these services, run:
+---
 
-```console
-$ process-compose down
-```
-
-To start the bot, run:
-
-```console
-$ cargo run --release
-```
-
-### Manual (Not recommended)
+### Manual Setup (Not Recommended)
 
-If you want to set up the bot manually, you need to install the following dependencies:
+To set up manually, install:
 
-- [`Rust`](https://www.rust-lang.org/tools/install)
-- [`PostgreSQL`](https://www.postgresql.org/download/)
-- [`Lavalink`](https://lavalink.dev/getting-started/index.html)
+- [Rust](https://www.rust-lang.org/tools/install)
+- [PostgreSQL](https://www.postgresql.org/download/)
+- [Lavalink](https://lavalink.dev/getting-started/index.html)
 
-Follow the official documentation on how to set up and configure these tools.
-
-Then, clone the repository and run the following command:
+Follow their official documentation for configuration. Then:
 
 ```console
 $ cargo run --release
 ```
 
+---
+
 ## Attributions
 
-- [`twilight-rs`](https://twilight.rs/) - Powerful, flexible, and scalable ecosystem of Rust libraries for the Discord API.
-- [`Lavalink`](https://lavalink.dev/) - Standalone audio sending node based on Lavaplayer.
-  - [`lavalink-rs`](https://gitlab.com/vicky5124/lavalink-rs/) - Lavalink bindings for asynchronous rust discord libraries.
+- [twilight-rs](https://twilight.rs/) - Scalable Rust libraries for Discord API.
+- [Lavalink](https://lavalink.dev/) - Standalone audio node based on Lavaplayer.
+  - [lavalink-rs](https://gitlab.com/vicky5124/lavalink-rs/) - Async Lavalink bindings for Rust Discord libraries.