dartdoc the AppWindow

more or less a copy / paste from the javascript API docs with small
style fix (dart style guide uses 'this' instead of 'the' on instance
method docs)