Add-ons guide?

Are there plans to release some documentation on the add ons? The basic descriptions of both Custom Comments Template and Social Discussion leave much to the imagination and I'm having a hard time figuring out if I'm using them right because I'm not sure what an ideal end result would even look like. Thanks for any advice!