working on generating docs as part of the build

revert PATH changes

fix typo

some dartdoc changes in files

.travis.yml

@@ -11,4 +11,5 @@ addons:
     - g++-4.8
 before_script:
   - ./travis/setup.sh
-script: ./travis/build.sh
+script:
+  - ./travis/build.sh

sky/packages/sky/.gitignore

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

sky/packages/sky/doc/firebase.json

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

sky/packages/sky/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';

sky/packages/sky/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

sky/packages/sky/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';

sky/tools/skydoc.py

@@ -25,7 +25,7 @@ def main():
          help='Open docs after building.')
     args = parser.parse_args()
 
-    doc_dir = os.path.join(SKY_PACKAGE, 'doc')
+    doc_dir = os.path.join(SKY_PACKAGE, 'doc', 'api')
 
     cmd = [
         DARTDOC,

travis/build.sh

 #!/bin/bash
 set -ex
 
-# Smoke test sky_shell
+# Smoke test sky_shell.
 ./out/sky_shell --help
 
+# Run the tests.
 pushd sky/unit
 SKY_SHELL=../../out/sky_shell ../../third_party/dart-sdk/dart-sdk/bin/pub run sky_tools:sky_test -j 1
 popd
 
+# Analyze the code.
 pushd sky/packages/sky
 ../../../third_party/dart-sdk/dart-sdk/bin/dartanalyzer lib/widgets.dart
 popd
+
+# Generate docs.
+./sky/tools/skydoc.py

travis/setup.sh

@@ -3,12 +3,7 @@ set -ex
 
 ./tools/dart/update.py
 
-pushd sky/unit
-../../third_party/dart-sdk/dart-sdk/bin/pub get
-popd
-
-pushd sky/packages/sky
-../../../third_party/dart-sdk/dart-sdk/bin/pub get
-popd
+(cd sky/unit; ../../third_party/dart-sdk/dart-sdk/bin/pub get)
+(cd sky/packages/sky; ../../../third_party/dart-sdk/dart-sdk/bin/pub get)
 
 ./sky/tools/download_sky_shell.py sky/unit/packages/sky_engine/REVISION out