Doc global variables approach
Address initial feedback
Merge pull request #320 from Polymer/issue-318

Doc global variables approach (for #318)