Merge pull request #991 from flutter/all_docs

Generate docs for more of our packages

doc/index.html

@@ -69,6 +69,21 @@ from a single codebase.
           <dd>The main Flutter framework libraries.</dd>
         </dl>
 
+        <h3>Supporting Packages</h3>
+
+        <dl>
+          <dt><a href="/flutter_test/">flutter_test</a></dt>
+          <dd>Testing library for Flutter, built on top of package:test.</dd>
+
+          <dt><a href="/cassowary/">cassowary</a></dt>
+          <dd>An implementation of the Cassowary constraint solving algorithm.</dd>
+
+          <dt><a href="/newton/">newton</a></dt>
+          <dd>Simple physics simulations.</dd>
+
+          <dt><a href="/playfair/">playfair</a></dt>
+          <dd>A simple charting library for Flutter.</dd>
+        </dl>
           </article>
         </div>
 

packages/cassowary/lib/cassowary.dart

@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+/// An implementation of the Cassowary constraint solving algorithm in Dart.
 library cassowary;
 
 import 'dart:math';

packages/flutter_test/lib/flutter_test.dart

@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+/// Testing library for flutter, built on top of package:test.
 library flutter_test;
 
 export 'src/test_pointer.dart';

packages/newton/lib/newton.dart

@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+/// Simple Physics Simulations for Dart. Springs, friction, gravity, etc.
 library newton;
 
 import 'dart:math' as math;

packages/playfair/lib/playfair.dart

@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+/// A simple charting library for Flutter.
 library playfair;
 
 import 'dart:ui' as ui;

travis/test.sh

@@ -22,14 +22,24 @@ if [ $TRAVIS_PULL_REQUEST = "false" ]; then
   if [ $TRAVIS_BRANCH = "master" ]; then
     pub global activate dartdoc 0.8.4
     cat packages/flutter/doc/styles.html doc/_analytics.html > /tmp/_header.html
+
+    # TODO(eseidel): This should just call a helper script.
+    # If you add a package to this list, update doc/index.html to point to it.
     (cd packages/flutter; ~/.pub-cache/bin/dartdoc --header=/tmp/_header.html)
+    (cd packages/playfair; ~/.pub-cache/bin/dartdoc --header=/tmp/_header.html)
+    (cd packages/newton; ~/.pub-cache/bin/dartdoc --header=/tmp/_header.html)
+    (cd packages/cassowary; ~/.pub-cache/bin/dartdoc --header=/tmp/_header.html)
+    (cd packages/flutter_test; ~/.pub-cache/bin/dartdoc --header=/tmp/_header.html)
 
     GSUTIL=$HOME/google-cloud-sdk/bin/gsutil
     GCLOUD=$HOME/google-cloud-sdk/bin/gcloud
     $GCLOUD auth activate-service-account --key-file gcloud_key_file.json
-    $GSUTIL -m -q rsync -r -d packages/flutter/doc/api gs://docs.flutter.io/flutter
-    $GSUTIL -m -q rsync -r -d packages/flutter/doc/api gs://docs.domokit.org/flutter
     $GSUTIL -m -q cp doc/index.html gs://docs.flutter.io/index.html
-    $GSUTIL -m -q cp doc/index.html gs://docs.domokit.org/index.html
+
+    $GSUTIL -m -q rsync -r -d packages/flutter/doc/api gs://docs.flutter.io/flutter
+    $GSUTIL -m -q rsync -r -d packages/playfair/doc/api gs://docs.flutter.io/playfair
+    $GSUTIL -m -q rsync -r -d packages/newton/doc/api gs://docs.flutter.io/newton
+    $GSUTIL -m -q rsync -r -d packages/cassowary/doc/api gs://docs.flutter.io/cassowary
+    $GSUTIL -m -q rsync -r -d packages/flutter_test/doc/api gs://docs.flutter.io/flutter_test
   fi
 fi