Fix sample code and update docs (#11257)
Fix sample code and update docs (#11257)

* fix sample code

* review comments

* review comments

* document other members for extra bonus points

tvolkert/flutter,cbracken/flutter,turnidge/flutter,flutter/flutter,Hixie/flutter,Hixie/flutter,tvolkert/flutter,cbracken/flutter,Hixie/flutter,flutter/flutter,flutter/flutter,Hixie/flutter,Hixie/flutter,flutter/flutter,flutter/flutter,Hixie/flutter,cbracken/flutter,tvolkert/flutter,tvolkert/flutter,tvolkert/flutter,cbracken/flutter,flutter/flutter,tvolkert/flutter,Hixie/flutter,tvolkert/flutter,tvolkert/flutter,turnidge/flutter,cbracken/flutter,Hixie/flutter,cbracken/flutter,flutter/flutter,cbracken/flutter,Hixie/flutter,turnidge/flutter,flutter/flutter,tvolkert/flutter,flutter/flutter,Hixie/flutter,turnidge/flutter,cbracken/flutter,cbracken/flutter,cbracken/flutter,flutter/flutter,turnidge/flutter,tvolkert/flutter