update README

Author: robertpeteuil

README.md

@@ -7,45 +7,30 @@
 - `py3.6`, `python3.6` [_(python3.6/Dockerfile)_](https://github.com/robertpeteuil/docker-nginx-uwsgi/blob/master/python3.6/Dockerfile)
 - `py3.6-alpine`, `python3.6-alpine` [_(python3.6-alpine/Dockerfile)_](https://github.com/robertpeteuil/docker-nginx-uwsgi/blob/master/python3.6-alpine/Dockerfile)
 
-**the `latest` tag is not assigned - explicitly use one of the tags above.**
+**You must explicitly use one of the tags above.** The `latest` tag is not assigned since each tag represents a different variant, not an incremental version.
 
->This is to prevent pulling an unexpected image, as the tags represent completely different image variants not incremental versions.
-
-# NGINX-UWSGI
+## NGINX-UWSGI
 
 **Docker** image with **Nginx**, **uWSGI** and **Python** running in a single container to enable running Python Web Apps on NGINX.
 
-> NOTE: This project is a derivative of the project at [tiangolo/UWSGI-NGINX-DOCKER](https://github.com/tiangolo/uwsgi-nginx-docker). It was created out of necessity to address urgent fixes and enhancements. This ultimately required creating derivatives of both the [base images](https://github.com/robertpeteuil/docker-nginx-uwsgi) and the [flask images](https://github.com/robertpeteuil/docker-nginx-uwsgi-flask).
-
 **GitHub Repo**: <https://github.com/robertpeteuil/docker-nginx-uwsgi>
 
 **Docker Hub Images**: <https://hub.docker.com/r/robpco/nginx-uwsgi/>
 
-# Overview
+## Overview
 
 This Docker image allow the creation/migration of Python Web Apps to run on Nginx and uWSGI in a single container. It's designed for use as base image for:
+
 - Other images - such as a pre-built image for running Flask Apps [nginx-uwsgi-flask](https://github.com/robertpeteuil/docker-nginx-uwsgi-flask) .
 - A development image that can be customized with your unique web-framework, Python libraries and code.
 
 This repo auto-generates images to [Docker-Hub](https://hub.docker.com/r/robpco/nginx-uwsgi/). It includes standard and alpine-based variants for each supported Python version (2.7, 3.5, 3.6).
 
-# Enhancements
-
-The image used in this repo includes the following enhancements (over previous repos):
-- Adds image variants built on alpine-linux
-- Updated built-in Nginx to 1.13.7 on non-alpine variants
-- Reduces CRIT errors from `supervisord`
- - `supervisord.conf` is explicitly referenced via the Dockerfile CMD statement
- - `supervisord.conf` includes an explicitly set user-name
-- Manually Building the image is protected against failures from key-server outages
-
-# Information
+## Usage
 
 The Docker-Hub [repository](https://hub.docker.com/r/robpco/nginx-uwsgi/) contains auto-generated images from this repo. They can be referenced (or pulled) by using the image name `robpco/nginx-uwsgi`, plus a tag for the python version desired (ex: `:python3.6`), and optionally appending `-alpine` to the tag (for alpine variants).
 
-**Detailed usage documentation and examples can be found on the repo [tiangolo/UWSGI-NGINX-DOCKER](https://github.com/tiangolo/uwsgi-nginx-docker).**
-
-# Custom Environment Variables
+## Custom Environment Variables
 
 This image supports the following custom environment variables:
 
@@ -57,27 +42,25 @@ This image supports the following custom environment variables:
 - **LISTEN_PORT** - custom port that Nginx should listen on
  - 80 = Nginx default
 
-# Setting Environment Variables
+## Setting Environment Variables
 
 Environment variables can be set in multiple ways. The following examples, demonstrate setting the `LISTEN_PORT` environment variable via three different methods. These methods apply to the other Environment Variables as well.
 
-**Setting in a `Dockerfile`**
+### Setting in a `Dockerfile`
 
 ```dockerfile
 # ... (snip) ...
 ENV LISTEN_PORT 8080
 # ... (snip) ...
 ```
 
-
-**Setting during [`docker run`](https://docs.docker.com/engine/reference/commandline/run/#options) with the `-e` option**
+### Setting during [`docker run`](https://docs.docker.com/engine/reference/commandline/run/#options) with the `-e` option
 
 ```shell
 docker run -e LISTEN_PORT=8080 -p 8080:8080 myimage
 ```
 
-
-**Setting in `docker-compose` file using the `environment:` keyword in a `docker-compose` file**
+### Setting in `docker-compose` file using the `environment:` keyword in a `docker-compose` file
 
 ```yml
 version: '2.2'
@@ -88,8 +71,10 @@ services:
  LISTEN_PORT: 8080
 ```
 
+Inspired by the project at [tiangolo/UWSGI-NGINX-DOCKER](https://github.com/tiangolo/uwsgi-nginx-docker).
+
+## UPDATES
 
-# UPDATES
 - 2017-12-11: Added multiple tags per variant: `py3.6` is the same as `python3.6`, and so forth...
 - 2017-11-29: Added ability to change port Nginx listens on with new environment variable `LISTEN_PORT`.
  - Thanks to github user [tmshn](https://github.com/tmshn)
@@ -98,8 +83,8 @@ services:
 - 2017-11-29: Automatic image re-build when Python updates
 - 2017-11-28: Updated Nginx version installed on non-Alpine images
 
+## CHANGELOG
 
-# FIXES
 - 2017-12-15: Fix to avoid duplicate listen entries in nginx.conf
 - 2017-11-30: Alpine images - eliminated uWSGI random build failures
 - 2017-11-30: Non-Alpine images - limit build failures caused by GPG key validation failing