Clarified the README documentation.

I just started using your swagger generator for Go. Thanks for getting this started. 

Here are a whole bunch of suggested changes to the README.

FYI: As you can see by some of my comments, I'm struggling with using this to define the API's in my microservices world where we are NOT using the first path segment to correspond to a "resource" (sub-api). Instead, each "resource" is it's own (micro)service with a unique base path. -- But anyway, my tests so far have me convinced that I'll be able to make it work somehow.