From fa6c58978ba1559d655c6c1ba9f018aeb2086438 Mon Sep 17 00:00:00 2001
From: David Mc Ken <david.mcken@gmail.com>
Date: Thu, 8 Dec 2022 22:50:25 -0400
Subject: [PATCH] Cleaned up mysql setup process.

---
 .../database-setup/Setup-MySQL-or-MariaDB.md  | 29 ++++++++++---------
 1 file changed, 16 insertions(+), 13 deletions(-)

diff --git a/docs/wiki/database-setup/Setup-MySQL-or-MariaDB.md b/docs/wiki/database-setup/Setup-MySQL-or-MariaDB.md
index 8e9186d..f028984 100644
--- a/docs/wiki/database-setup/Setup-MySQL-or-MariaDB.md
+++ b/docs/wiki/database-setup/Setup-MySQL-or-MariaDB.md
@@ -2,23 +2,26 @@
 
 This guide will show you how to prepare a MySQL or MariaDB database for PowerDNS-Admin.
 
+We assume the database is installed per your platform's directions (apt, yum, etc).
+
 ## Setup database:
-1. ivan@ubuntu:~$ `mysql -u root -p` (then enter your MySQL/MariaDB root users password)
-2. mysql> `CREATE DATABASE powerdnsadmin CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;`
-3. mysql> `GRANT ALL PRIVILEGES ON powerdnsadmin.* TO 'pdnsadminuser'@'%' IDENTIFIED BY 'p4ssw0rd';`
-4. mysql> `FLUSH PRIVILEGES;`
-5. mysql> `quit`
+
+Connect to the database (Usually using `mysql -u root -p` - then enter your MySQL/MariaDB root users password if applicable), then enter the following:
+```
+CREATE DATABASE `powerdnsadmin` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
+GRANT ALL PRIVILEGES ON `powerdnsadmin`.* TO 'pdnsadminuser'@'localhost' IDENTIFIED BY 'YOUR_PASSWORD_HERE';
+FLUSH PRIVILEGES;
+quit
+```
 
 ## Known issues:
 
-If you plan to manage large zones, you may encounter some issues while applying changes.
-This is due to PowerDNS-Admin trying to insert the entire modified zone into the column history.detail.
+Problem: If you plan to manage large zones, you may encounter some issues while applying changes. This is due to PowerDNS-Admin trying to insert the entire modified zone into the column history.detail.
 
 Using MySQL/MariaDB, this column is created by default as TEXT and thus limited to 65,535 characters.
 
-_Solution_:
-
-Convert the column to MEDIUMTEXT: 
-
-* `USE powerdnsadmin;`
-* `ALTER TABLE history MODIFY detail MEDIUMTEXT;`
+Solution: Convert the column to MEDIUMTEXT:
+```
+USE powerdnsadmin;
+ALTER TABLE history MODIFY detail MEDIUMTEXT;
+```