Adds API documentation for SkyGames

Adds API documentation, improves the API names, and cleans up code.

R=ianh@google.com

Committed: https://chromium.googlesource.com/external/mojo/+/e130a78ef72116ca013dcde201c7364b7dad7091

[viktorl, 2015-06-22 17:02:10]

viktorl@google.com changed reviewers:
+ ianh@google.com

[jackson, 2015-06-22 17:04:42]

jackson@google.com changed reviewers:
+ jackson@google.com

[jackson, 2015-06-22 17:04:43]

I think we usually use two // for comments. Is there a reason you used ///?

[viktorl, 2015-06-22 17:08:34]

On 2015/06/22 at 17:04:43, jackson wrote:
> I think we usually use two // for comments. Is there a reason you used ///?

I tried to follow the docs for Dart API docs:
https://www.dartlang.org/articles/doc-comment-guidelines/

[Hixie, 2015-06-22 17:08:42]

lgtm

https://codereview.chromium.org/1201983004/diff/1/sky/examples/game/lib/node....
File sky/examples/game/lib/node.dart (right):

https://codereview.chromium.org/1201983004/diff/1/sky/examples/game/lib/node....
sky/examples/game/lib/node.dart:424: ///       applyTransformForPivot(canvas);
note that save/transform/restore is expensive (expensive enough that we do
translate/-translate for most widgets, and are considering even removing that
where we can).

[viktorl, 2015-06-22 17:13:27]

Committed patchset #1 (id:1) manually as
e130a78ef72116ca013dcde201c7364b7dad7091 (presubmit successful).

[jackson, 2015-06-22 17:36:54]

I did not know that was a thing. thanks!