README: Updated format and various wording

Author: wltjr

README.md

@@ -4,41 +4,40 @@
 [![Build Status](https://img.shields.io/shippable/5840e5d8112fc80f00e0cb41/master.svg?colorA=9977bb&style=plastic)](https://app.shippable.com/projects/5840e5d8112fc80f00e0cb41/)
 [![Code Quality](https://img.shields.io/coverity/scan/12326.svg?colorA=9977bb&style=plastic)](https://scan.coverity.com/projects/obsidian-studiosinc-jem)
 
-These are the release notes for jem. Read them carefully,
-as they tell you what this is all about, explain how to install jem,
-and what to do if something goes wrong.
+## About
 
-## WHAT IS JEM?
+jem is a Java Environment Manager, a re-write and port to C of a 
+program on Gentoo Linux called 
+[java-config](https://github.com/gentoo/java-config), written in 
+python, specific to Gentoo Linux and derivatives. jem being in C, is 
+Linux distro agnostic and should work for any POSIX compliant 
+operating system. The intention is to standardize java management and 
+tools for scripts and programs.
 
-  jem is a java environment manager, a re-write and port to C of 
-  a program on Gentoo Linux called java-config, written in python and
-  specific to Gentoo Linux and derivatives. jem being in C, is Linux 
-  distro agnostic and should work for any POSIX compliant operating 
-  system. The intention is to standardize java management and tools for 
-  scripts and programs.
+jem provides means to manage and set system and user virtual machines 
+independently. Along with ability to build package classpath and other 
+things for a variety of uses. By using jem systems can have portable  
+and consistent access to java virtual machines and packages.
 
-  jem provides means to manage and set system and user virtual machines 
-  independently. Along with ability to build package classpath and other 
-  things for a variety of uses. By using jem systems can have portable 
-  and consistent access to java virtual machines and packages.
+## Documentation:
 
-## DOCUMENTATION:
+Documentation is generated from jem sources in the docs subdirectory  
+after compiling jem. API documentation is created using doxygen and man 
+page created from help2man. At some point a version will be placed 
+online. For time being need to generation documentation yourself as 
+needed. Or part of a system package.
 
-  Documentation is generated from jem sources in the docs subdirectory 
-  after compiling jem. API documentation is created using doxygen and 
-  man page created from help2man.
+## Download:
 
-## DOWNLOAD:
+jem binaries and sources are currently available for download via 
+[releases](https://github.com/Obsidian-StudiosInc/jem/releases).
 
-  jem binaries and sources are currently available for download at
-  http://o-sinc.com/#/software/jem
+## Configuring:
 
-## CONFIGURING:
-
-  In the root directory of the sources, run the following commands to 
-  configure cmake sources. cmake uses autotools by default. jem can be 
-  built with ninja instead of autotools for faster builds. Little chance 
-  of switching to meson build system.
+In the root directory of the sources, run the following commands to  
+configure cmake sources. cmake uses autotools by default. jem can be  
+built with ninja instead of autotools for faster builds. Little chance  
+of switching to meson build system.
 
  - To build jem with debugging symbols
 
@@ -55,7 +54,7 @@ cmake -D CMAKE_BUILD_TYPE=Release ./
  - To build using ninja instead of autotools add -G Ninja to either
 
 
-## COMPILING:
+## Compiling:
 jem can be compiled via autotools or ninja
 
 ### Autotools
@@ -87,11 +86,11 @@ ninja
 ninja jem-test
 ```
 
-## INSTALLING:
+## Installing:
 
-  Installing jem should be done through the systems package manager. For 
-  integration with package managers and/or manual installation you can 
-  run the following command.
+Installing jem should be done through the systems package manager. For 
+integration with package managers and/or manual installation you can 
+run the following command.
 
 ### Autotools
 Install using autotools
@@ -105,11 +104,11 @@ Install using ninja
 ninja install
 ```
 
-## PACKAGING:
+## Packaging:
 
-  jem's build system can also build DEB, RPM, and TBZ2 packages for 
-  distribution. To build all the above targets (they cannot be build 
-  individually at this time) run the following command.
+jem's build system can also build DEB, RPM, and TBZ2 packages for 
+distribution. To build all the above targets (they cannot be build 
+individually at this time) run the following command.
 
 ### Autotools
 ```