add installation instructions to pkg packages

BUG=

Review URL: https://codereview.chromium.org//14188048

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart/pkg/yaml@21770 260f80e4-7a28-3924-810f-c04153c831b5
diff --git a/lib/yaml.dart b/lib/yaml.dart
index 94e3d42..85861d5 100644
--- a/lib/yaml.dart
+++ b/lib/yaml.dart
@@ -4,6 +4,21 @@
 
 /// A parser for [YAML](http://www.yaml.org/).
 ///
+/// ## Installing ##
+///
+/// Use [pub][] to install this package. Add the following to your
+/// `pubspec.yaml` file.
+///
+///     dependencies:
+///       yaml: any
+///
+/// Then run `pub install`.
+///
+/// For more information, see the
+/// [yaml package on pub.dartlang.org][pkg].
+///
+/// ## Using ##
+///
 /// Use [loadYaml] to load a single document, or [loadYamlStream] to load a
 /// stream of documents. For example:
 ///
@@ -22,6 +37,9 @@
 ///       var doc = loadYaml("YAML: YAML Ain't Markup Language");
 ///       print(json.stringify(doc));
 ///     }
+///
+/// [pub]: http://pub.dartlang.org
+/// [pkg]: http://pub.dartlang.org/packages/yaml
 library yaml;
 
 import 'src/composer.dart';