@voltrue2 I think we should add some documentation for the validate method. I'm also happy to submit a PR for this. I'm receiving the following errors sometimes and it is unclear without investigating the code whether this means the request failed or if the receipt is invalid. In my particular case, both of these failures were for valid receipts.

{ Error: read ECONNRESET
    at TLSWrap.

I found it useful to parse the api.json and pull out the route -> method -> function name and dump it in the readme.md of a project. This doesn't have to be baked into shep, but I figured I'd open a discussion about it.

I also evaluated a few swagger api markdown generators and they are not ideal. I've done similar setups with jsdoc2md where you end up with

So people don't (necessarily) need to install this package, document how to use it with npx (part of npm now).

Hey,

I was about to try your library which looks very promising. Could you add some kind of information on how to setup the DynamoDB and what would be the primaryKey for it?

I cannot initialize the kinesis consumer

const Kinesis = require('lifion-kinesis');
const streamName = 'testStream';
const logger = require('tracer).console({level:'debug'});

const kinesisConsumer 

any decent docs for this ? like what Q.item and Q.work do exactly, quite hard to read code if one is not a promises guru

The AWS v4 signing process makes it difficult to test that these specs actually work against the real AWS API, but moto has an option to disable authentication, and has a "standalone server" mode where it looks like the AWS API (which is why it's the basis of [localstack](https://github.com/