docs cleanup (#3196)

* some docs cleanup

* update styles

* remove unused file
diff --git a/dev/docs/.gitignore b/dev/docs/.gitignore
index 2744c6b..4bf79c1 100644
--- a/dev/docs/.gitignore
+++ b/dev/docs/.gitignore
@@ -4,5 +4,5 @@
 pubspec.lock
 
 pubspec.yaml
-api/
+doc/api/
 lib/
diff --git a/dev/docs/styles.html b/dev/docs/styles.html
index 02b90c1..e3dc2b3 100644
--- a/dev/docs/styles.html
+++ b/dev/docs/styles.html
@@ -18,13 +18,18 @@
   h1 {
     font-size: 42px !important;
     letter-spacing: -1px;
-    line-height: 1;
+    line-height: 1.1;
   }
 
   h2 {
     font-size: 32px;
   }
 
+  .sidebar ol,
+  .sidebar ol li.section-title {
+    font-size: inherit;
+  }
+
   pre > code {
     font-size: 14px;
   }
diff --git a/doc/_analytics.html b/doc/_analytics.html
deleted file mode 100644
index c3c1f30..0000000
--- a/doc/_analytics.html
+++ /dev/null
@@ -1,9 +0,0 @@
-<script>
-  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
-  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
-  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
-  })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
-
-  ga('create', 'UA-67589403-2', 'auto');
-  ga('send', 'pageview');
-</script>
diff --git a/doc/index.html b/doc/index.html
deleted file mode 100644
index 1db959f..0000000
--- a/doc/index.html
+++ /dev/null
@@ -1,127 +0,0 @@
-<!DOCTYPE html>
-<html>
-  <head>
-    <meta charset="utf-8">
-    <meta http-equiv="X-UA-Compatible" content="IE=edge">
-    <meta name="viewport" content="width=device-width, initial-scale=1">
-    <link href="https://fonts.googleapis.com/css?family=Source+Code+Pro|Roboto:500,400italic,300,400" rel="stylesheet" type="text/css">
-    <title>Flutter API Docs</title>
-    <meta name="description" content="Flutter API docs">
-    <link rel="stylesheet" href="http://flutter.io/css/main.css">
-    <link rel="canonical" href="http://docs.flutter.io/">
-    <link rel="shortcut icon" href="http://flutter.io/favicon.ico">
-    <script>
-      (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
-      (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
-      m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
-      })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
-
-      ga('create', 'UA-67589403-2', 'auto');
-      ga('send', 'pageview');
-    </script>
-    <style>
-      .page-content {
-        padding: 15px 0 15px 0;
-      }
-
-      dt {
-        font-size: 20px;
-      }
-    </style>
-  </head>
-  <body>
-    <header class="site-header">
-      <div class="wrapper">
-        <a class="site-title" href="/">Flutter API Docs</a>
-        <nav class="site-nav">
-          <a href="#" class="menu-icon">
-            <svg viewBox="0 0 18 15">
-              <path fill="#424242" d="M18,1.484c0,0.82-0.665,1.484-1.484,1.484H1.484C0.665,2.969,0,2.304,0,1.484l0,0C0,0.665,0.665,0,1.484,0 h15.031C17.335,0,18,0.665,18,1.484L18,1.484z"/>
-              <path fill="#424242" d="M18,7.516C18,8.335,17.335,9,16.516,9H1.484C0.665,9,0,8.335,0,7.516l0,0c0-0.82,0.665-1.484,1.484-1.484 h15.031C17.335,6.031,18,6.696,18,7.516L18,7.516z"/>
-              <path fill="#424242" d="M18,13.516C18,14.335,17.335,15,16.516,15H1.484C0.665,15,0,14.335,0,13.516l0,0 c0-0.82,0.665-1.484,1.484-1.484h15.031C17.335,12.031,18,12.696,18,13.516L18,13.516z"/>
-            </svg>
-          </a>
-          <!-- TODO: search -->
-        </nav>
-      </div>
-    </header>
-    <div class="page-content">
-      <div class="wrapper">
-        <div class="post">
-          <header class="post-header">
-          </header>
-          <article class="post-content">
-            <p>Flutter is a new project to help developers
-              build high-performance, high-fidelity,
-              mobile apps for iOS and Android
-              from a single codebase.
-              <em>Flutter is an early-stage open-source project.</em>
-            </p>
-            <h3>APIs</h3>
-            <dl>
-              <dt><a href="/flutter/">flutter</a></dt>
-              <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 <code>package:test</code>.</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>
-              <dt><a href="/flutter_sprites/">flutter_sprites</a></dt>
-              <dd>A sprite toolkit built on top of Flutter.</dd>
-            </dl>
-          </article>
-        </div>
-      </div>
-    </div>
-    <footer class="site-footer">
-      <div class="wrapper">
-        <div class="footer-col-wrapper">
-          <div class="footer-col footer-col-all">
-            <div class="logo">
-              <svg width="138" height="88" viewBox="0, 0, 138, 88">
-                <path style="fill:#917FFF;stroke:#FFFFFF"
-                  d="M76.4457337257,68.7452964326 C101.752495779,57.3530559496 135.725273541,36.7508699436 137.277276695,27.9537925266 C139.020387832,18.0734752246 107.915173462,3.92339415459 97.4530579447,14.4850425266 C95.1465857817,16.8134576466 93.4051234527,19.9608116636 90.2871451447,25.7303597706
-                  C83.4782275207,38.3296705796 80.6965459177,43.5220231536 72.4379212257,60.0055503386"/>
-                <path style="fill:#917FFF;stroke:#FFFFFF"
-                  d="M70.1859681007,71.5577964326 C53.6924782047,79.3410536876 21.3511379877,87.9323432556 10.8895813827,87.2345542446 C-0.569589177341,86.4702240796 0.167012582659,71.1381905366 0.808526694659,64.1232261206
-                  C1.488675985659,56.6857855696 11.6428135557,52.8666953906 16.2610736157,54.1728108736 C31.4302764167,58.4628964016 39.3239571067,60.1654189286 63.2787415377,65.2824058076"/>
-                <path style="fill:#C17FFF;stroke:#FFFFFF"
-                  d="M62.9970032567,65.2179526826 C35.7624401197,59.7527053476 31.5365086327,58.4229596446 16.4313860597,54.0262146736 C5.501511163659,50.8447858396 4.485308601659,38.4254490056 7.263604819659,34.3751792456
-                  C16.5292274657,20.8675226556 38.8852752047,26.7885268026 41.1854798197,24.9391440886 C44.1062927437,22.5907873836 48.4834815267,11.2805581096 66.4120423197,2.08758158859 C79.2369795017,-4.48848147341 98.1220582767,10.5374053906 90.1752619167,25.6336385076
-                  C83.3176166697,38.6608518136 80.5025840477,43.9089156316 72.3554016947,60.0524253386"/>
-                <path style="fill:none;stroke:#917FFF"
-                  d="M76.3044902367,70.9561037246 C78.3960485157,71.1152751536 80.8837389927,72.0497411666 82.5466777357,73.1357912246"/>
-                <path style="fill:none;stroke:#917FFF"
-                  d="M74.1747421897,78.9875197396 C73.5907633597,77.2543737016 73.1612175077,74.8484721426 73.3666367197,72.8654494276"/>
-                <path style="fill:#7F9DFF;stroke:#FFFFFF"
-                  d="M75.3978821637,72.3585776826 C67.6445429637,78.2751666966 36.8970328207,27.9635637636 41.1740052107,24.9553794406 C45.5338006747,22.0644831736 82.2169468337,67.6594945666 75.3978821637,72.3585776826 z"/>
-              </svg>
-            </div>
-            <ul class="contact-list">
-              <li><a href="https://flutter.io">Flutter</a></li>
-            </ul>
-            <p class="terms">
-              <a href="https://twitter.com/flutterio">@flutterio</a> &bull;
-              <a href="mailto:flutter-dev@googlegroups.com">flutter-dev@</a> &bull;
-              <a href="/tos">terms</a> &bull;
-              <a href="http://www.google.com/intl/en/policies/privacy/">privacy</a>
-            </p>
-            <p class="licenses">
-              Except as otherwise noted,
-              this work is licensed under a
-              <a rel="license" href="http://creativecommons.org/licenses/by/4.0/">Creative
-              Commons Attribution 4.0 International License</a>,
-              and code samples are licensed under the BSD License.
-            </p>
-          </div>
-        </div>
-      </div>
-    </footer>
-  </body>
-</html>
diff --git a/packages/flutter/doc/styles.html b/packages/flutter/doc/styles.html
deleted file mode 100644
index 02b90c1..0000000
--- a/packages/flutter/doc/styles.html
+++ /dev/null
@@ -1,49 +0,0 @@
-<!-- style overrides for dartdoc -->
-<style>
-  header {
-    background-color: #917FFF;
-  }
-
-  body {
-    font-size: 16px;
-    line-height: 1.5;
-    color: #111;
-    background-color: #fdfdfd;
-  }
-
-  h1, h2, h3, h4, h5, h6 {
-    font-weight: 300;
-  }
-
-  h1 {
-    font-size: 42px !important;
-    letter-spacing: -1px;
-    line-height: 1;
-  }
-
-  h2 {
-    font-size: 32px;
-  }
-
-  pre > code {
-    font-size: 14px;
-  }
-</style>
-
-<!-- The following rules are from http://google.github.io/material-design-icons/ -->
-<link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">
-<style>
-  /* Rules for sizing the icon. */
-  .material-icons.md-18 { font-size: 18px; }
-  .material-icons.md-24 { font-size: 24px; }
-  .material-icons.md-36 { font-size: 36px; }
-  .material-icons.md-48 { font-size: 48px; }
-
-  /* Rules for using icons as black on a light background. */
-  .material-icons.md-dark { color: rgba(0, 0, 0, 0.54); }
-  .material-icons.md-dark.md-inactive { color: rgba(0, 0, 0, 0.26); }
-
-  /* Rules for using icons as white on a dark background. */
-  .material-icons.md-light { color: rgba(255, 255, 255, 1); }
-  .material-icons.md-light.md-inactive { color: rgba(255, 255, 255, 0.3); }
-</style>