Improve advanced install docs

Author: rustprooflabs

ADVANCED-INSTALL.md

@@ -1,23 +1,88 @@
 # PgDD Advanced installation
 
-This page covers installing PgDD from source locally, and the Docker build
-method based on [ZomboDB's build system](https://github.com/zombodb/zombodb)
-used to create the binaries for multiple versions.
+This page covers two methods that can be used to build binary installers
+for PgDD.
+The two methods that can be used to build binaries are the Docker build system
+and manually installing `pgrx` on the target OS and architecture.
+Installers are specific to three (3) details:
 
+* CPU Architecture
+* Operating System version
+* Postgres version
 
-## Create Binary installer for your system
+
+The Docker build method uses OS specific `Dockerfile` to provide one binary
+installer for each supported Postgres version.  This is the best approach
+when the appropriate `Dockerfile` already exists.
+
+
+## Use Docker to build binary packages
+
+The Docker build method was originally based on
+[ZomboDB's build system](https://github.com/zombodb/zombodb) and has
+evolved with this project since then.
+
+To generate the full suite of binaries change into the `./build` directory
+and run `build.sh`.  This currently creates 15 total binary installers for
+3 different OSs (Postgres 12 - 16).
+
+```bash
+cd build/
+time bash ./build.sh
+```
+
+Individual installers can be found under `./target/artifacts`.  A package of
+all installers is saved to `./build/pgdd-binaries.tar.gz`.
+
+> Tagged versions of PgDD include LTS OS binaries with their [release notes](https://github.com/rustprooflabs/pgdd/releases).
+
+
+### Customize Docker Build system
+
+The Docker build system can be adjusted locally to build a binary for
+a specific Postgres version and/or specific OS.
+
+The `./build/build.sh` script has the logic to be adjusted to control this.
+The Postgres versions can be  altered manually by commenting out the line
+with all versions and uncommenting the line with a specific Postgres version.
+The two lines in the script are shown below.
+
+```bash
+PG_VERS=("pg12" "pg13" "pg14" "pg15" "pg16")
+#PG_VERS=("pg16")
+```
+
+
+To only build for Postgres on a single OS, add a `grep <osname` command to the
+loop logic.  The original file that runs for all OSs with Dockerfiles looks like
+the following line.
+
+```bash
+for image in `ls docker/ ` ; do
+```
+
+To build for only `lunar` (Ubuntu 23.04) add ` | grep lunar ` as shown in the
+following example.
+
+```bash
+for image in `ls docker/ | grep lunar ` ; do
+```
+
+
+## Create Binary Installer w/out Docker
 
 The following steps walk through creating a package on a typical
-Ubuntu based system with Postgres 15.
+Ubuntu based system with Postgres 15.  These manual instructions can be used
+when you do not want to use the Docker based build system under `./build/`.
 
 
-### Prereqs
+### Prerequisites
 
-pgrx and its dependencies are the main prereq for PgDD.
-Install Prereqs and ensure PostgreSQL dev tools are installed.
+The main perquisites for PgDD are `pgrx` and its dependencies.
+Install prereqs and ensure PostgreSQL dev tools are installed.
 
-> See the [Cargo pgrx](https://github.com/tcdi/pgrx/tree/master/cargo-pgrx)
-documentation for more information on using pgrx.
+> See the [cargo pgrx](https://github.com/pgcentralfoundation/pgrx/tree/master/cargo-pgrx)
+documentation for more information on using `pgrx`.
 
 
 ```bash
@@ -48,7 +113,7 @@ cargo install cargo-deb
 ```
 
 
-Initialize pgrx.  Need to run this after install AND occasionally to get updates
+Initialize `pgrx`.  Need to run this after install AND occasionally to get updates
 to Postgres versions or glibc updates.  Not typically required to follow pgrx
 developments.
 
@@ -101,42 +166,6 @@ sudo dpkg -i --force-overwrite ./pgdd.deb
 
 
 
-## Use Docker to build binary packages
-
-Ubuntu 22.04 (Jammy) binaries are available for 0.5.1 for Postgres 12
-through Postgres 16.
-
-
-```bash
-cd build/
-time bash ./build.sh
-```
-
-Tagged versions will be attached to their [releases](https://github.com/rustprooflabs/pgdd/releases).
-
-### Specific Postgres version and OS
-
-The `./build.sh` is setup to loop through all supported Postgres versions and OSs.
-
-The Postgres version behavior can be altered manually by commenting out the line
-with all versions and uncommenting the line with a specific Postgres version:
-
-```bash
-PG_VERS=("pg12" "pg13" "pg14" "pg15" "pg16")
-#PG_VERS=("pg16")
-```
-
-To limit to a single OS change this line:
-
-```bash
-for image in `ls docker/ ` ; do
-```
-
-To `grep <osname>` to limit.
-
-```bash
-for image in `ls docker/ | grep lunar ` ; do
-```
 
 ## pgrx Generate graphviz