Comments and Clean Up

[Jayshua]

This is a very large diff. I'm not really expecting a merge as-is. I can do another request with fewer changes if you like. (Maybe removing the TODO comments.) Mainly I want to get your opinion on the direction I'm modifying the code - Are you likely to merge the changes I'd like to make? I don't want to end up with yet another separately maintained copy of this tool.

Here's a summary of the changes so far:

• Fixed the compile errors pull request Fix: Type 'GraphQLType' is not assignable to type 'GraphQLOutputType'. module name on Windows #1 tried to. (Seems recent versions of TypeScript include Promise typings. These were conflicting with the Promise typing in this repo.)
• Removed errorSpec
• Removed the requirement of a src/ directory
• Added lots of comments
• Added lots of TODO comments

[Bellk17]

Sorry, haven't looked as this repo in awhile (been stable for my needs). Will look at the PR in depth in a bit; I agree with the forks, and definitely alot of room for improvement.