Add docs for Polymer helper functions

Address #666, #353, and partially addresses #244 (swiped some material from Addy's doc, but we should get the full doc in here at some point).