Difficulties doc

I want to create a document that outlines all the difficulties people have had using the API. I feel like we have a lot of really good data in the forum, in @probablycorey's analysis of the packages, etc. It would be nice to get it all in one place so we can make some informed decisions.

Feel free to suggest changes on this PR or add them to this doc.