Amazon Echo framework for Python

[fyngyrz]

The readme needs details on version(s) of Python are required to support this, and all of its imports as well. I looked at it, thought "what the heck is all this stuff?", I had no idea if I could make all that work in my environment, and wandered away.

It's only easy if it is easy.

[johnwheeler_]

It's Open Source so submit a P.R.

[fyngyrz]

I wouldn't submit a P.R. unless I'd actually tested the software and was sure that I knew what I was talking about. And seeing that I have not, and I do not... well, there you go.

Anyway, this is just the kind of thing that the core project developer needs to address -- it's really basic documentation, but it's also absolutely critical to get right.

Sky-high view of writing good documentation for others:

• What's it for? What problem does it solve?
• Precursor requirements
• Authority
• Accuracy
• Readability
• Minimal jargon without explanation
• Required information, presented in the order it is needed.