Fix the description of debounce (dart-lang/stream_transform#101)
It is the most recent, or "last" event in a series that is emitted. See
discussion in dart-lang/stream_transform#100
Change the word "period" to "series of closely spaced events" since
there is no fixed length of time.
diff --git a/pkgs/stream_transform/CHANGELOG.md b/pkgs/stream_transform/CHANGELOG.md
index 5342392..3cada22 100644
--- a/pkgs/stream_transform/CHANGELOG.md
+++ b/pkgs/stream_transform/CHANGELOG.md
@@ -1,3 +1,5 @@
+## 1.1.2-dev
+
## 1.1.1
- Fix a bug in `asyncMapSample`, `buffer`, `combineLatest`,
diff --git a/pkgs/stream_transform/lib/src/rate_limit.dart b/pkgs/stream_transform/lib/src/rate_limit.dart
index 15078b7..40b77ef 100644
--- a/pkgs/stream_transform/lib/src/rate_limit.dart
+++ b/pkgs/stream_transform/lib/src/rate_limit.dart
@@ -9,8 +9,10 @@
/// Utilities to rate limit events.
///
-/// - [debounce] - emit the _first_ event at the _end_ of the period.
-/// - [debounceBuffer] - emit _all_ events at the _end_ of the period.
+/// - [debounce] - emit the _last_ event at the _end_ of a series of closely
+/// spaced events.
+/// - [debounceBuffer] - emit _all_ events at the _end_ of a series of closely
+/// spaced events.
/// - [throttle] - emit the _first_ event at the _beginning_ of the period.
/// - [audit] - emit the _last_ event at the _end_ of the period.
/// - [buffer] - emit _all_ events on a _trigger_.
