working on generating docs as part of the build

revert PATH changes

fix typo

some dartdoc changes in files

packages/flutter/.gitignore

@@ -3,3 +3,4 @@
 AUTHORS
 LICENSE
 pubspec.lock
+doc/api/

packages/flutter/doc/firebase.json

+{
+  "firebase": "skydocs",
+  "public": "api",
+  "ignore": [
+    "firebase.json",
+    "**/.*",
+    "**/node_modules/**"
+  ]
+}

packages/flutter/lib/rendering.dart

@@ -2,9 +2,9 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// Includes and re-exports all Sky rendering classes.
-
-/// The Sky render tree
+/// The Sky render tree.
+///
+/// This library includes and re-exports all Sky rendering classes.
 library rendering;
 
 export 'package:sky/src/rendering/auto_layout.dart';

packages/flutter/lib/src/widgets/framework.dart

@@ -247,7 +247,7 @@ abstract class Widget {
     }
   }
 
-  /// Walks the immediate children of this widget
+  /// Walks the immediate children of this widget.
   ///
   /// Override this if you have children and call walker on each child.
   /// Note that you may be called before the child has had its parent

packages/flutter/lib/widgets.dart

@@ -2,9 +2,9 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// Includes and re-exports all Sky widgets classes.
-
-/// The Sky widget framework
+/// The Sky widget framework.
+///
+/// This library includes and re-exports all Sky widgets classes.
 library widgets;
 
 export 'package:sky/src/widgets/animated_component.dart';