update styles for the generated dartdocs (#3276)

* styles updates for the api docs

* update library docs

* use the new --favion and --use-categories options for dartdoc

dev/dartdoc.dart

@@ -41,13 +41,15 @@ dependencies:
   if (code != 0)
     exit(code);
 
-  // Generate the documentation; we require dartdoc >= 0.9.3+1.
+  // Generate the documentation; we require dartdoc >= 0.9.4.
   List<String> args = <String>[
     'global', 'run', 'dartdoc',
     '--header', 'styles.html',
     '--header', 'analytics.html',
     '--dart-sdk', '../../bin/cache/dart-sdk',
-    '--exclude', 'temp_doc'
+    '--exclude', 'temp_doc',
+    '--favicon=favicon.ico',
+    '--use-categories'
   ];
   for (String libraryRef in _libraryRefs()) {
     String name = _entityName(libraryRef);

dev/docs/styles.html

@@ -9,6 +9,7 @@
     line-height: 1.5;
     color: #111;
     background-color: #fdfdfd;
+    font-weight: 300;
   }
 
   h1, h2, h3, h4, h5, h6 {
@@ -18,11 +19,25 @@
   h1 {
     font-size: 42px !important;
     letter-spacing: -1px;
-    line-height: 1.1;
+  }
+
+  header h1 {
+    font-weight: 300;
   }
 
   h2 {
+    color: #111;
+    font-size: 26px;
+  }
+
+  .markdown h2 {
+    font-size: 24px;
+  }
+
+  section.summary h2 {
     font-size: 32px;
+    color: inherit;
+    border-bottom: none;
   }
 
   .sidebar ol,
@@ -30,8 +45,59 @@
     font-size: inherit;
   }
 
+  .sidebar-offcanvas-left ol {
+    padding: 0 16px 16px 0;
+  }
+
+  .sidebar h5 {
+    padding-top: 0 !important;
+    text-transform: uppercase;
+  }
+
+  .sidebar-offcanvas-left {
+    background-color: inherit;
+  }
+
+  .sidebar-offcanvas-left h5 {
+    border-bottom: none;
+    padding: 0 0 16px 0;
+  }
+
+  .sidebar-offcanvas-left h5:last-of-type {
+    padding: 0 0 16px 0;
+  }
+
+  pre,
+  pre.prettyprint,
   pre > code {
-    font-size: 14px;
+    font-size: 15px;
+  }
+
+  pre,
+  pre.prettyprint {
+    background: inherit;
+    border: none;
+    margin: 0 0 15px 0;
+    padding: 8px 12px;
+  }
+
+  code {
+    background-color: inherit;
+  }
+
+  dl.dl-horizontal dt {
+    color: inherit;
+  }
+
+  footer {
+    border-top: 1px solid #e8e8e8;
+    height: inherit;
+    padding-bottom: 15px;
+    text-transform: lowercase;
+  }
+
+  footer p {
+    color: #828282;
   }
 </style>
 

packages/flutter/lib/animation.dart

@@ -4,7 +4,7 @@
 
 /// The Flutter animation system.
 ///
-/// See <https://flutter.io/animations/> for an overview.
+/// See [flutter.io/animations](https://flutter.io/animations/) for an overview.
 ///
 /// This library depends only on core Dart libraries and the `newton` package.
 library animation;

packages/flutter/lib/material.dart

@@ -4,7 +4,9 @@
 
 /// Flutter widgets implementing Material Design.
 ///
-/// See https://www.google.com/design/spec/material-design/introduction.html
+/// See
+/// [www.google.com/design/spec/material-design](https://www.google.com/design/spec/material-design/introduction.html)
+/// for an introduction to Material Design.
 library material;
 
 export 'src/material/app.dart';

packages/flutter/lib/src/material/icon.dart

@@ -6,6 +6,7 @@ import 'package:flutter/widgets.dart';
 
 import 'colors.dart';
 import 'icons.dart';
+import 'icon_button.dart';
 import 'icon_theme.dart';
 import 'theme.dart';
 

packages/flutter/lib/src/material/icons.dart

@@ -38,7 +38,7 @@ class IconData {
 ///
 ///  * [Icon]
 ///  * [IconButton]
-///  * <https://design.google.com/icons/>
+///  * [design.google.com/icons](https://design.google.com/icons/)
 class Icons {
   Icons._();
 

packages/flutter_test/lib/flutter_test.dart

@@ -2,7 +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.
+/// Testing library for flutter, built on top of `package:test`.
 library flutter_test;
 
 export 'src/instrumentation.dart';