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 to help us make some informed decisions.

Feel free to suggest changes on this PR or add them directly to the md doc.