Cleanup of READMEs prior to tag

Author: dwasyluk

README.md

@@ -1,16 +1,30 @@
 # Generating API
 
-To generate the API first download swagger-codegen () and build it. After its built, create an alias:
-alias swagger-codegen='java -jar [/path/to/built/swagger-codegen]/swagger-codegen/modules/swagger-codegen-cli/target/swagger-codegen-cli.jar'
+To generate the API first download [swagger-codegen](https://github.com/swagger-api/swagger-codegen) and build it. After its built, create an alias:
 
-To rebuild the JSON API spec due to YAML changes (required for docs UI to be accurate): `generate -i swagger.yaml -o ./generated-json -l swagger`
+`alias swagger-codegen='java -jar [/path/to/built/swagger-codegen]/swagger-codegen/modules/swagger-codegen-cli/target/swagger-codegen-cli.jar'`
 
-To build the server stub (node): `swagger-codegen generate -i swagger.yaml -o ./server/generated-server -l nodejs-server`
+##Generating the JSON Spec 
+Anytime the root swagger.yaml is modified the JSON spec should be updated and copied into 
+`swagger-ui/dist/swagger-spec.js` as the value for the `swaggerSpec` var. Currently this is a manual process.
 
-To build the client (typescript): `swagger-codegen generate -i swagger.yaml -o ./client/generated-client -l typescript-node`
+To regenerate the JSON API spec due to YAML changes (required for docs UI to be accurate): `generate -i swagger.yaml -o ./generated-json -l swagger`. 
+The generated JSON can be deleted after its been copied to `swagger-spec.js`.
 
-The API can be built for a number of other languages as well but you will need to manually port the business logic from the existing nodesjs-server \
-API to the languages of your choice. We encourage anyone who does this to submit a pull request to have their server API added to the official repo.
+##Generating Server Stubs
+You can contribute to the syscoin-api project by writing connectors for Syscoin in different languages.
+Swagger-codegen can greatly reduce the time it takes to write connectors in other languages by generating a server-api stub 
+in the desired language. To generate the Server stub use the command below replacing LANGUAGE with one of the [supported SwaggerJS server values](https://github.com/swagger-api/swagger-codegen/wiki/Server-stub-generator-HOWTO).
 
+To build the server SDK stub: `swagger-codegen generate -i swagger.yaml -o ./server/generated-server -l LANGUAGE`
+
+We encourage anyone who does this to submit a pull request to have their server API added to the official repo. 
 Package your server API using folder names mirroring the swagger language name, ie: 'nodejs-server'. Client API's can also be submitted using the same \
- format.
+ format.
+
+##Generating the Client SDK
+To quickly start communicating with an instance of the Syscoin API server simply generate a client-side SDK 
+in your preferred language. To generate the Client SDK use the command below replacing LANGUAGE with one of 
+the [supported SwaggerJS client values](https://generator.swagger.io/#!/clients/clientOptions).
+
+To build the client: `swagger-codegen generate -i swagger.yaml -o ./client/generated-client -l LANGUAGE`

server/nodejs/README.md

@@ -1,25 +1,23 @@
-# Swagger generated server
-
-## Overview
-This server was generated by the [swagger-codegen](https://github.com/swagger-api/swagger-codegen) project.  By using the [OpenAPI-Spec](https://github.com/OAI/OpenAPI-Specification) from a remote server, you can easily generate a server stub.  This is an example of building a node.js server.
-
-This example uses the [expressjs](http://expressjs.com/) framework.  To see how to make this your own, look here:
-
-[README](https://github.com/swagger-api/swagger-codegen/blob/master/README.md)
-
-### Running the server
+## Running the server
 To run the server, follow these simple steps:
 
 ```
 npm install
 npm run start
 ```
 
-### Running the server in daemon mode
-To run the server as a daemon use the below command after `npm install` completes:
+## Running the server in daemon mode
+Running the server in daemon mode is dependent on [pm2](https://www.npmjs.com/package/pm2). To run the server as a daemon use the below command after `npm install` completes:
 
 ```
 npm run startd
 ```
 
+## Configuring for Production Use
+Before deploying syscoin-api for production use you will need to modify the `swaggerSpec.host` value located in `../../swagger-ui/dist/swagger-spec.js` from 
+`localhost:8001` to `SERVERIP:8001`. Replacing SERVERIP with your server's production IP or domain. You can also optionally change the port. It is highly recommended that you 
+allow only HTTPS access in production and secure connections with a valid SSL certificate.
+
+
+### Credits
 This project leverages the mega-awesome [swagger-tools](https://github.com/apigee-127/swagger-tools) middleware which does most all the work.