From 2e4fb21acae124b8bd1c36641a01a22ca2b5003a Mon Sep 17 00:00:00 2001
From: Quddus Chong <quddusc@google.com>
Date: Thu, 10 Mar 2016 10:26:46 -0800
Subject: [PATCH] api docs: Add descriptions for Scafold, Theme, and ThemeData
 classes.

---
 packages/flutter/lib/src/material/scaffold.dart   | 5 +++++
 packages/flutter/lib/src/material/theme.dart      | 2 ++
 packages/flutter/lib/src/material/theme_data.dart | 3 +++
 3 files changed, 10 insertions(+)

diff --git a/packages/flutter/lib/src/material/scaffold.dart b/packages/flutter/lib/src/material/scaffold.dart
index f606b41fe7..e29eec3144 100644
--- a/packages/flutter/lib/src/material/scaffold.dart
+++ b/packages/flutter/lib/src/material/scaffold.dart
@@ -175,6 +175,11 @@ class _FloatingActionButtonTransitionState extends State<_FloatingActionButtonTr
   }
 }
 
+/// Implements the basic material design visual layout structure.
+///
+/// This class provides APIs for showing drawers, snackbars, and bottom sheets.
+///
+/// See: <https://www.google.com/design/spec/layout/structure.html>
 class Scaffold extends StatefulComponent {
   Scaffold({
     Key key,
diff --git a/packages/flutter/lib/src/material/theme.dart b/packages/flutter/lib/src/material/theme.dart
index d6458e320c..bdd887d7cc 100644
--- a/packages/flutter/lib/src/material/theme.dart
+++ b/packages/flutter/lib/src/material/theme.dart
@@ -10,6 +10,7 @@ export 'theme_data.dart' show ThemeData, ThemeBrightness;
 
 const kThemeAnimationDuration = const Duration(milliseconds: 200);
 
+/// Applies a theme to descendant widgets.
 class Theme extends InheritedWidget {
   Theme({
     Key key,
@@ -20,6 +21,7 @@ class Theme extends InheritedWidget {
     assert(data != null);
   }
 
+  /// Specifies the color and typography values for descendant widgets.
   final ThemeData data;
 
   static final ThemeData _kFallbackTheme = new ThemeData.fallback();
diff --git a/packages/flutter/lib/src/material/theme_data.dart b/packages/flutter/lib/src/material/theme_data.dart
index 694377fc6e..2e67425fb1 100644
--- a/packages/flutter/lib/src/material/theme_data.dart
+++ b/packages/flutter/lib/src/material/theme_data.dart
@@ -27,6 +27,9 @@ const Color _kLightThemeSplashColor = const Color(0x66C8C8C8);
 const Color _kDarkThemeHighlightColor = const Color(0x40CCCCCC);
 const Color _kDarkThemeSplashColor = const Color(0x40CCCCCC);
 
+/// Holds the color and typography values for a material design theme.
+///
+/// Use this class to configure a [Theme] widget.
 class ThemeData {
 
   ThemeData.raw({