diff --git a/stdlib/public/core/Filter.swift b/stdlib/public/core/Filter.swift
index 67a24c84f4fc9..333bc387b7ca6 100644
--- a/stdlib/public/core/Filter.swift
+++ b/stdlib/public/core/Filter.swift
@@ -148,12 +148,12 @@ public func == (
/// A lazy `CollectionType` wrapper that includes the elements of an
/// underlying collection that satisfy a predicate.
///
-/// - Note: The performance of advancing a `LazyFilterIndex`
-/// depends on how sparsely the filtering predicate is satisfied,
-/// and may not offer the usual performance given by models of
-/// `ForwardIndexType`. Be aware, therefore, that general operations
-/// on `LazyFilterCollection` instances may not have the
-/// documented complexity.
+/// - Note: The performance of accessing `startIndex`, `first`, any methods
+/// that depend on `startIndex`, or of advancing a `LazyFilterIndex` depends
+/// on how sparsely the filtering predicate is satisfied, and may not offer
+/// the usual performance given by `CollectionType` or `ForwardIndexType`. Be
+/// aware, therefore, that general operations on `LazyFilterCollection`
+/// instances may not have the documented complexity.
public struct LazyFilterCollection<
Base : CollectionType
> : LazyCollectionType {
diff --git a/stdlib/public/core/Flatten.swift.gyb b/stdlib/public/core/Flatten.swift.gyb
index 438f9e1548388..200baea526ba2 100644
--- a/stdlib/public/core/Flatten.swift.gyb
+++ b/stdlib/public/core/Flatten.swift.gyb
@@ -225,6 +225,14 @@ public func == (
/// * `c.flatten().map(f)` maps eagerly and returns a new array
/// * `c.lazy.flatten().map(f)` maps lazily and returns a `LazyMapCollection`
///
+/// - Note: The performance of accessing `startIndex`, `first`, any methods
+/// that depend on `startIndex`, or of advancing a `${Collection}Index`
+/// depends on how many empty subcollections are found in the base
+/// collection, and may not offer the usual performance given by
+/// `CollectionType` or `${traversal}IndexType`. Be aware, therefore, that
+/// general operations on `${Collection}` instances may not have the
+/// documented complexity.
+///
/// - See also: `FlattenSequence`
public struct ${Collection}<
Base: CollectionType where ${constraints % {'Base': 'Base.'}}