diff --git a/README.md b/README.md
index 1fc9691..0565d8d 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,27 @@
 
 Reading data from package contents and files.
 
+A resource is data that can be read into a Dart program at runtime.
+A resource is identified by a URI. It can be loaded as bytes or data.
+The resource URI may be a package: URI.
+
+Example:
+
+```
+import 'package:resource/resource.dart' show Resource;
+import 'dart:convert' show UTF8;
+
+main() async {
+  var resource = new Resource("package:foo/foo_data.txt");
+  var string = await resource.readAsString(UTF8);
+  print(string);
+}
+```
+
+## Learning more
+
+Please check out the [API docs](https://www.dartdocs.org/documentation/resource/latest).
+
 ## Features and bugs
 
 The current version of `resource.dart` depends on the `dart:io` library,