Directions for custom nginx builds (#63)

Update readme.md and comments in scripts/build_nginx

Author: agrberg

changelog.md

@@ -4,6 +4,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.5.1] - 2020-08-22
+### Changes
+- [readme.md] Updated custom build instructions
+- [scripts/build_nginx] Updated outdated comments
+
 ## [1.5] - 2020-07-20
 ### Added
 - [all] move to tgz to distribute binaries

readme.md

@@ -110,15 +110,25 @@ You can provide your own NGINX config by creating a file named `nginx.conf.erb`
 
 ### Customizable NGINX Compile Options
 
-See [scripts/build_nginx](scripts/build_nginx) for the build steps. Configuring is as easy as changing the "./configure" options.
+This requires a clone of this repository and [Docker](https://www.docker.com/). All you need to do is have Docker setup and running on your machine. The [`Makefile`](Makefile) will take care of the rest.
 
-You can run the builds in a [Docker](https://www.docker.com/) container:
+Configuring is as easy as changing the options passed to `./configure` in [scripts/build_nginx](scripts/build_nginx).
+
+Run the builds in a container via:
+
+```
+$ make build
+```
+
+The binaries will be packed into `tar` files and placed in the repository's root directory. Commit the changes and push your repository.
+
+Finally update your app to use your custom buildpack on Heroku either at https://dashboard.heroku.com/apps/#{YOUR_APP_NAME}/settings or via the Heroku CLI via:
 
 ```
-$ make build # It outputs the latest builds to bin/cedar-*
+heroku buildpacks:set #{YOUR_GIT_REPO_CLONE}
 ```
 
-To test the builds:
+To test the builds locally:
 
 ```
 $ make shell

scripts/build_nginx

@@ -1,13 +1,8 @@
 #!/bin/bash
-# Build NGINX and modules on Heroku.
-# This program is designed to run in a web dyno provided by Heroku.
-# We would like to build an NGINX binary for the builpack on the
-# exact machine in which the binary will run.
-# Our motivation for running in a web dyno is that we need a way to
-# download the binary once it is built so we can vendor it in the buildpack.
-#
-# Once the dyno has is 'up' you can open your browser and navigate
-# this dyno's directory structure to download the nginx binary.
+# Build NGINX and modules for Heroku.
+# This script is designed to run in a Heroku Stack Docker
+# image. More information on the Heroku Stack can be found
+# at https://devcenter.heroku.com/articles/stack
 
 NGINX_VERSION=${NGINX_VERSION-1.18.0}
 PCRE_VERSION=${PCRE_VERSION-8.44}
@@ -41,6 +36,7 @@ echo "Downloading $zlib_url"
 echo "Downloading $uuid4_url"
 (cd nginx-${NGINX_VERSION} && curl -L $uuid4_url | tar xvz )
 
+# This will build `nginx`
 (
   cd nginx-${NGINX_VERSION}
   ./configure \
@@ -55,6 +51,7 @@ echo "Downloading $uuid4_url"
   make install
 )
 
+# This will build `nginx-debug`
 (
   cd nginx-${NGINX_VERSION}
   ./configure \