On 5/3/2011 6:32 PM, Gregory Crosswhite wrote:
I really want to emphasize this again since it is so important: a user considering using your library is not going to care about all of the fancy technical details behind it, he or she will want to know what kinds of problems it solves and how specifically it can be used to solve them, and you spend almost no time talking about this. Your library can be the greatest piece of code in the world but if it takes forever for anyone to learn how to use it then nobody will bother because there are plenty of "good enough" libraries out there that don't require as much trouble.
A comparison with shared_ptr should be helpful since everybody now should know shared_ptr (I'm basically expecting a user to know the standards). -Phil