Merge pull request swiftlang#29436 from amartini51/master

Author: swift-ci

stdlib/public/core/Array.swift

@@ -432,7 +432,7 @@ extension Array: _ArrayProtocol {
   ///
   ///     numbers.append(contentsOf: stride(from: 60, through: 100, by: 10))
   ///     // numbers.count == 10
-  ///     // numbers.capacity == 12
+  ///     // numbers.capacity == 10
   @inlinable
   public var capacity: Int {
     return _getCapacity()

stdlib/public/core/ArraySlice.swift

@@ -249,7 +249,7 @@ extension ArraySlice: _ArrayProtocol {
   ///
   ///     numbers.append(contentsOf: stride(from: 60, through: 100, by: 10))
   ///     // numbers.count == 10
-  ///     // numbers.capacity == 12
+  ///     // numbers.capacity == 10
   @inlinable
   public var capacity: Int {
     return _getCapacity()

stdlib/public/core/ContiguousArray.swift

@@ -120,7 +120,7 @@ extension ContiguousArray: _ArrayProtocol {
   ///
   ///     numbers.append(contentsOf: stride(from: 60, through: 100, by: 10))
   ///     // numbers.count == 10
-  ///     // numbers.capacity == 12
+  ///     // numbers.capacity == 10
   @inlinable
   public var capacity: Int {
     return _getCapacity()

stdlib/public/core/Integers.swift

@@ -696,7 +696,7 @@ public protocol BinaryInteger :
   /// A type that represents the words of a binary integer.
   ///
   /// The `Words` type must conform to the `RandomAccessCollection` protocol
-  /// with an `Element` type of `UInt` and `Index` type of `Int.
+  /// with an `Element` type of `UInt` and `Index` type of `Int`.
   associatedtype Words: RandomAccessCollection
       where Words.Element == UInt, Words.Index == Int
 

stdlib/public/core/RangeReplaceableCollection.swift

@@ -952,7 +952,7 @@ extension RangeReplaceableCollection {
   /// concatenate the elements of an integer array and a `Range<Int>` instance.
   ///
   ///     let numbers = [1, 2, 3, 4]
-  ///     let moreNumbers = numbers + 5...10
+  ///     let moreNumbers = numbers + (5...10)
   ///     print(moreNumbers)
   ///     // Prints "[1, 2, 3, 4, 5, 6, 7, 8, 9, 10]"
   ///
@@ -981,7 +981,7 @@ extension RangeReplaceableCollection {
   /// concatenate the elements of a `Range<Int>` instance and an integer array.
   ///
   ///     let numbers = [7, 8, 9, 10]
-  ///     let moreNumbers = 1...6 + numbers
+  ///     let moreNumbers = (1...6) + numbers
   ///     print(moreNumbers)
   ///     // Prints "[1, 2, 3, 4, 5, 6, 7, 8, 9, 10]"
   ///