effect 4.0.0-beta.71 → 4.0.0-beta.72

package/src/Chunk.ts

@@ -319,7 +319,7 @@ const makeChunk = <A>(backing: Backing<A>): Chunk<A> => {
 }
 
 /**
- * Checks if `u` is a `Chunk<unknown>`
+ * Checks whether `u` is a `Chunk<unknown>`
  *
  * **Example** (Checking for chunks)
  *
@@ -339,7 +339,7 @@ const makeChunk = <A>(backing: Backing<A>): Chunk<A> => {
  */
 export const isChunk: {
   /**
-   * Checks if `u` is a `Chunk<unknown>`
+   * Checks whether `u` is a `Chunk<unknown>`
    *
    * **Example** (Checking for chunks)
    *
@@ -359,7 +359,7 @@ export const isChunk: {
    */
   <A>(u: Iterable<A>): u is Chunk<A>
   /**
-   * Checks if `u` is a `Chunk<unknown>`
+   * Checks whether `u` is a `Chunk<unknown>`
    *
    * **Example** (Checking for chunks)
    *
@@ -580,7 +580,15 @@ const reverseChunk = <A>(self: Chunk<A>): Chunk<A> => {
 
 /**
  * Reverses the order of elements in a `Chunk`.
- * Importantly, if the input chunk is a `NonEmptyChunk`, the reversed chunk will also be a `NonEmptyChunk`.
+ *
+ * **When to use**
+ *
+ * Use to read or process chunk elements in reverse order.
+ *
+ * **Details**
+ *
+ * If the input chunk is a `NonEmptyChunk`, the reversed chunk is also a
+ * `NonEmptyChunk`.
  *
  * **Example** (Reversing chunks)
  *
@@ -599,7 +607,8 @@ const reverseChunk = <A>(self: Chunk<A>): Chunk<A> => {
 export const reverse: <S extends Chunk<any>>(self: S) => Chunk.With<S, Chunk.Infer<S>> = reverseChunk as any
 
 /**
- * This function provides a safe way to read a value at a particular index from a `Chunk`.
+ * Gets the value at an index in a `Chunk` safely, returning `None` when the index is
+ * out of bounds.
  *
  * **Example** (Accessing elements safely)
  *
@@ -622,7 +631,8 @@ export const reverse: <S extends Chunk<any>>(self: S) => Chunk.With<S, Chunk.Inf
  */
 export const get: {
   /**
-   * This function provides a safe way to read a value at a particular index from a `Chunk`.
+   * Gets the value at an index in a `Chunk` safely, returning `None` when the index is
+   * out of bounds.
    *
    * **Example** (Accessing elements safely)
    *
@@ -645,7 +655,8 @@ export const get: {
    */
   (index: number): <A>(self: Chunk<A>) => Option<A>
   /**
-   * This function provides a safe way to read a value at a particular index from a `Chunk`.
+   * Gets the value at an index in a `Chunk` safely, returning `None` when the index is
+   * out of bounds.
    *
    * **Example** (Accessing elements safely)
    *
@@ -674,7 +685,8 @@ export const get: {
 )
 
 /**
- * Wraps an array into a chunk without copying, unsafe on mutable arrays
+ * Wraps an array into a chunk without copying, so mutating the source array can
+ * mutate the chunk.
  *
  * **Example** (Creating chunks without copying arrays)
  *
@@ -697,7 +709,8 @@ export const fromArrayUnsafe = <A>(self: ReadonlyArray<A>): Chunk<A> =>
   self.length === 0 ? empty() : self.length === 1 ? of(self[0]) : makeChunk({ _tag: "IArray", array: self })
 
 /**
- * Wraps an array into a chunk without copying, unsafe on mutable arrays
+ * Wraps a non-empty array into a non-empty chunk without copying, so mutating
+ * the source array can mutate the chunk.
  *
  * **Example** (Creating non-empty chunks without copying arrays)
  *
@@ -903,7 +916,7 @@ export const append: {
 } = dual(2, <A, A2>(self: Chunk<A>, a: A2): NonEmptyChunk<A | A2> => appendAll(self, of(a)))
 
 /**
- * Prepend an element to the front of a `Chunk`, creating a new `NonEmptyChunk`.
+ * Prepends an element to the front of a `Chunk`, creating a new `NonEmptyChunk`.
  *
  * **Example** (Prepending an element)
  *
@@ -925,7 +938,7 @@ export const append: {
  */
 export const prepend: {
   /**
-   * Prepend an element to the front of a `Chunk`, creating a new `NonEmptyChunk`.
+   * Prepends an element to the front of a `Chunk`, creating a new `NonEmptyChunk`.
    *
    * **Example** (Prepending an element)
    *
@@ -947,7 +960,7 @@ export const prepend: {
    */
   <B>(elem: B): <A>(self: Chunk<A>) => NonEmptyChunk<B | A>
   /**
-   * Prepend an element to the front of a `Chunk`, creating a new `NonEmptyChunk`.
+   * Prepends an element to the front of a `Chunk`, creating a new `NonEmptyChunk`.
    *
    * **Example** (Prepending an element)
    *
@@ -1902,7 +1915,7 @@ export const filterMapWhile: {
 })
 
 /**
- * Filter out optional values
+ * Filters out optional values
  *
  * **Example** (Compacting optional values)
  *
@@ -2477,7 +2490,7 @@ export const isEmpty = <A>(self: Chunk<A>): boolean => self.length === 0
 export const isNonEmpty = <A>(self: Chunk<A>): self is NonEmptyChunk<A> => self.length > 0
 
 /**
- * Returns the first element of this chunk if it exists.
+ * Returns the first element of this chunk safely if it exists.
  *
  * **Example** (Getting the first element)
  *
@@ -2544,7 +2557,7 @@ export const headUnsafe = <A>(self: Chunk<A>): A => getUnsafe(self, 0)
 export const headNonEmpty: <A>(self: NonEmptyChunk<A>) => A = headUnsafe
 
 /**
- * Returns the last element of this chunk if it exists.
+ * Returns the last element of this chunk safely if it exists.
  *
  * **Example** (Getting the last element)
  *
@@ -2843,7 +2856,7 @@ export const map: {
     fromArrayUnsafe(pipe(toReadonlyArray(self), RA.map((a, i) => f(a, i)))))
 
 /**
- * Statefully maps over the chunk, producing new elements of type `B`.
+ * Maps over the chunk statefully, producing new elements of type `B`.
  *
  * **Example** (Mapping with accumulated state)
  *
@@ -2874,7 +2887,7 @@ export const map: {
  */
 export const mapAccum: {
   /**
-   * Statefully maps over the chunk, producing new elements of type `B`.
+   * Maps over the chunk statefully, producing new elements of type `B`.
    *
    * **Example** (Mapping with accumulated state)
    *
@@ -2905,7 +2918,7 @@ export const mapAccum: {
    */
   <S, A, B>(s: S, f: (s: S, a: A) => readonly [S, B]): (self: Chunk<A>) => [S, Chunk<B>]
   /**
-   * Statefully maps over the chunk, producing new elements of type `B`.
+   * Maps over the chunk statefully, producing new elements of type `B`.
    *
    * **Example** (Mapping with accumulated state)
    *
@@ -3083,7 +3096,7 @@ export const separate = <A, B>(self: Chunk<Result<B, A>>): [Chunk<A>, Chunk<B>]
 export const size = <A>(self: Chunk<A>): number => self.length
 
 /**
- * Sort the elements of a Chunk in increasing order, creating a new Chunk.
+ * Sorts the elements of a `Chunk` in increasing order, creating a new `Chunk`.
  *
  * **Example** (Sorting chunks)
  *
@@ -3109,7 +3122,7 @@ export const size = <A>(self: Chunk<A>): number => self.length
  */
 export const sort: {
   /**
-   * Sort the elements of a Chunk in increasing order, creating a new Chunk.
+   * Sorts the elements of a `Chunk` in increasing order, creating a new `Chunk`.
    *
    * **Example** (Sorting chunks)
    *
@@ -3135,7 +3148,7 @@ export const sort: {
    */
   <B>(O: Order.Order<B>): <A extends B>(self: Chunk<A>) => Chunk<A>
   /**
-   * Sort the elements of a Chunk in increasing order, creating a new Chunk.
+   * Sorts the elements of a `Chunk` in increasing order, creating a new `Chunk`.
    *
    * **Example** (Sorting chunks)
    *
@@ -3166,7 +3179,7 @@ export const sort: {
 )
 
 /**
- * Sorts the elements of a Chunk based on a projection function.
+ * Sorts the elements of a `Chunk` based on a projection function.
  *
  * **Example** (Sorting chunks by a derived value)
  *
@@ -3200,7 +3213,7 @@ export const sort: {
  */
 export const sortWith: {
   /**
-   * Sorts the elements of a Chunk based on a projection function.
+   * Sorts the elements of a `Chunk` based on a projection function.
    *
    * **Example** (Sorting chunks by a derived value)
    *
@@ -3234,7 +3247,7 @@ export const sortWith: {
    */
   <A, B>(f: (a: A) => B, order: Order.Order<B>): (self: Chunk<A>) => Chunk<A>
   /**
-   * Sorts the elements of a Chunk based on a projection function.
+   * Sorts the elements of a `Chunk` based on a projection function.
    *
    * **Example** (Sorting chunks by a derived value)
    *
@@ -3668,7 +3681,7 @@ export const splitWhere: {
 })
 
 /**
- * Returns every elements after the first.
+ * Returns every element after the first safely, or `None` when the chunk is empty.
  *
  * **Example** (Getting the tail safely)
  *
@@ -3691,7 +3704,7 @@ export const splitWhere: {
 export const tail = <A>(self: Chunk<A>): O.Option<Chunk<A>> => self.length > 0 ? O.some(drop(self, 1)) : O.none()
 
 /**
- * Returns every elements after the first.
+ * Returns every element after the first from a non-empty chunk.
  *
  * **Example** (Getting the tail of a non-empty chunk)
  *
@@ -4255,7 +4268,7 @@ export const zip: {
 )
 
 /**
- * Delete the element at the specified index, creating a new `Chunk`.
+ * Deletes the element at the specified index, creating a new `Chunk`.
  *
  * **Example** (Removing an element)
  *
@@ -4280,7 +4293,7 @@ export const zip: {
  */
 export const remove: {
   /**
-   * Delete the element at the specified index, creating a new `Chunk`.
+   * Deletes the element at the specified index, creating a new `Chunk`.
    *
    * **Example** (Removing an element)
    *
@@ -4305,7 +4318,7 @@ export const remove: {
    */
   (i: number): <A>(self: Chunk<A>) => Chunk<A>
   /**
-   * Delete the element at the specified index, creating a new `Chunk`.
+   * Deletes the element at the specified index, creating a new `Chunk`.
    *
    * **Example** (Removing an element)
    *
@@ -4335,7 +4348,7 @@ export const remove: {
 )
 
 /**
- * Applies a function to the element at the specified index, creating a new `Chunk`,
+ * Applies a function to the element at the specified index safely, creating a new `Chunk`,
  * or returns `None` if the index is out of bounds.
  *
  * **Example** (Modifying an element)
@@ -4361,7 +4374,7 @@ export const remove: {
  */
 export const modify: {
   /**
-   * Applies a function to the element at the specified index, creating a new `Chunk`,
+   * Applies a function to the element at the specified index safely, creating a new `Chunk`,
    * or returns `None` if the index is out of bounds.
    *
    * **Example** (Modifying an element)
@@ -4387,7 +4400,7 @@ export const modify: {
    */
   <A, B>(i: number, f: (a: A) => B): (self: Chunk<A>) => O.Option<Chunk<A | B>>
   /**
-   * Applies a function to the element at the specified index, creating a new `Chunk`,
+   * Applies a function to the element at the specified index safely, creating a new `Chunk`,
    * or returns `None` if the index is out of bounds.
    *
    * **Example** (Modifying an element)
@@ -4419,7 +4432,7 @@ export const modify: {
 )
 
 /**
- * Change the element at the specified index, creating a new `Chunk`,
+ * Changes the element at the specified index safely, creating a new `Chunk`,
  * or returns `None` if the index is out of bounds.
  *
  * **Example** (Replacing an element)
@@ -4445,7 +4458,7 @@ export const modify: {
  */
 export const replace: {
   /**
-   * Change the element at the specified index, creating a new `Chunk`,
+   * Changes the element at the specified index safely, creating a new `Chunk`,
    * or returns `None` if the index is out of bounds.
    *
    * **Example** (Replacing an element)
@@ -4471,7 +4484,7 @@ export const replace: {
    */
   <B>(i: number, b: B): <A>(self: Chunk<A>) => O.Option<Chunk<B | A>>
   /**
-   * Change the element at the specified index, creating a new `Chunk`,
+   * Changes the element at the specified index safely, creating a new `Chunk`,
    * or returns `None` if the index is out of bounds.
    *
    * **Example** (Replacing an element)
@@ -4870,7 +4883,7 @@ export const findFirst: {
 } = RA.findFirst
 
 /**
- * Return the first index for which a predicate holds.
+ * Returns the first index for which a predicate holds.
  *
  * **Example** (Finding the first matching index)
  *
@@ -4895,7 +4908,7 @@ export const findFirst: {
  */
 export const findFirstIndex: {
   /**
-   * Return the first index for which a predicate holds.
+   * Returns the first index for which a predicate holds.
    *
    * **Example** (Finding the first matching index)
    *
@@ -4920,7 +4933,7 @@ export const findFirstIndex: {
    */
   <A>(predicate: Predicate<A>): (self: Chunk<A>) => O.Option<number>
   /**
-   * Return the first index for which a predicate holds.
+   * Returns the first index for which a predicate holds.
    *
    * **Example** (Finding the first matching index)
    *
@@ -4950,7 +4963,7 @@ export const findFirstIndex: {
 )
 
 /**
- * Find the last element for which a predicate holds.
+ * Finds the last element for which a predicate holds.
  *
  * **Example** (Finding the last matching element)
  *
@@ -4976,7 +4989,7 @@ export const findFirstIndex: {
  */
 export const findLast: {
   /**
-   * Find the last element for which a predicate holds.
+   * Finds the last element for which a predicate holds.
    *
    * **Example** (Finding the last matching element)
    *
@@ -5002,7 +5015,7 @@ export const findLast: {
    */
   <A, B extends A>(refinement: Refinement<NoInfer<A>, B>): (self: Chunk<A>) => Option<B>
   /**
-   * Find the last element for which a predicate holds.
+   * Finds the last element for which a predicate holds.
    *
    * **Example** (Finding the last matching element)
    *
@@ -5028,7 +5041,7 @@ export const findLast: {
    */
   <A>(predicate: Predicate<NoInfer<A>>): (self: Chunk<A>) => Option<A>
   /**
-   * Find the last element for which a predicate holds.
+   * Finds the last element for which a predicate holds.
    *
    * **Example** (Finding the last matching element)
    *
@@ -5054,7 +5067,7 @@ export const findLast: {
    */
   <A, B extends A>(self: Chunk<A>, refinement: Refinement<A, B>): Option<B>
   /**
-   * Find the last element for which a predicate holds.
+   * Finds the last element for which a predicate holds.
    *
    * **Example** (Finding the last matching element)
    *
@@ -5082,7 +5095,7 @@ export const findLast: {
 } = RA.findLast
 
 /**
- * Return the last index for which a predicate holds.
+ * Returns the last index for which a predicate holds.
  *
  * **Example** (Finding the last matching index)
  *
@@ -5107,7 +5120,7 @@ export const findLast: {
  */
 export const findLastIndex: {
   /**
-   * Return the last index for which a predicate holds.
+   * Returns the last index for which a predicate holds.
    *
    * **Example** (Finding the last matching index)
    *
@@ -5132,7 +5145,7 @@ export const findLastIndex: {
    */
   <A>(predicate: Predicate<A>): (self: Chunk<A>) => O.Option<number>
   /**
-   * Return the last index for which a predicate holds.
+   * Returns the last index for which a predicate holds.
    *
    * **Example** (Finding the last matching index)
    *
@@ -5162,7 +5175,7 @@ export const findLastIndex: {
 )
 
 /**
- * Check if a predicate holds true for every `Chunk` element.
+ * Checks whether a predicate holds true for every `Chunk` element.
  *
  * **Example** (Checking every element)
  *
@@ -5190,7 +5203,7 @@ export const findLastIndex: {
  */
 export const every: {
   /**
-   * Check if a predicate holds true for every `Chunk` element.
+   * Checks whether a predicate holds true for every `Chunk` element.
    *
    * **Example** (Checking every element)
    *
@@ -5218,7 +5231,7 @@ export const every: {
    */
   <A, B extends A>(refinement: Refinement<NoInfer<A>, B>): (self: Chunk<A>) => self is Chunk<B>
   /**
-   * Check if a predicate holds true for every `Chunk` element.
+   * Checks whether a predicate holds true for every `Chunk` element.
    *
    * **Example** (Checking every element)
    *
@@ -5246,7 +5259,7 @@ export const every: {
    */
   <A>(predicate: Predicate<A>): (self: Chunk<A>) => boolean
   /**
-   * Check if a predicate holds true for every `Chunk` element.
+   * Checks whether a predicate holds true for every `Chunk` element.
    *
    * **Example** (Checking every element)
    *
@@ -5274,7 +5287,7 @@ export const every: {
    */
   <A, B extends A>(self: Chunk<A>, refinement: Refinement<A, B>): self is Chunk<B>
   /**
-   * Check if a predicate holds true for every `Chunk` element.
+   * Checks whether a predicate holds true for every `Chunk` element.
    *
    * **Example** (Checking every element)
    *
@@ -5308,7 +5321,7 @@ export const every: {
 )
 
 /**
- * Check if a predicate holds true for some `Chunk` element.
+ * Checks whether a predicate holds true for some `Chunk` element.
  *
  * **Example** (Checking for some matching element)
  *
@@ -5333,7 +5346,7 @@ export const every: {
  */
 export const some: {
   /**
-   * Check if a predicate holds true for some `Chunk` element.
+   * Checks whether a predicate holds true for some `Chunk` element.
    *
    * **Example** (Checking for some matching element)
    *
@@ -5358,7 +5371,7 @@ export const some: {
    */
   <A>(predicate: Predicate<NoInfer<A>>): (self: Chunk<A>) => self is NonEmptyChunk<A>
   /**
-   * Check if a predicate holds true for some `Chunk` element.
+   * Checks whether a predicate holds true for some `Chunk` element.
    *
    * **Example** (Checking for some matching element)
    *

package/src/Clock.ts

@@ -91,7 +91,7 @@ import * as effect from "./internal/effect.ts"
  */
 export interface Clock {
   /**
-   * Unsafely returns the current time in milliseconds.
+   * Returns the current time in milliseconds unsafely.
    *
    * **When to use**
    *
@@ -108,7 +108,7 @@ export interface Clock {
    */
   readonly currentTimeMillis: Effect<number>
   /**
-   * Unsafely returns the current time in nanoseconds.
+   * Returns the current time in nanoseconds unsafely.
    *
    * **When to use**
    *
@@ -135,7 +135,7 @@ export interface Clock {
 }
 
 /**
- * A reference to the current Clock service in the environment.
+ * Context reference for the current Clock service in the environment.
  *
  * **When to use**
  *

package/src/Combiner.ts

@@ -145,7 +145,7 @@ export function make<A>(combine: (self: A, that: A) => A): Combiner<A> {
  * **Details**
  *
  * Returns a new `Combiner` where `combine(self, that)` calls the original
- * combiner as `combine(that, self)`. The input combiner is not mutated.
+ * combiner as `combine(that, self)`.
  *
  * **Example** (reversing string concatenation)
  *
@@ -178,7 +178,7 @@ export function flip<A>(combiner: Combiner<A>): Combiner<A> {
  * **Details**
  *
  * The combiner compares values using the given `Order`. When values are equal,
- * it returns `that` (the second argument). It does not mutate either argument.
+ * it returns `that` (the second argument).
  *
  * **Example** (minimum of two numbers)
  *
@@ -214,7 +214,7 @@ export function min<A>(order: Order.Order<A>): Combiner<A> {
  * **Details**
  *
  * The combiner compares values using the given `Order`. When values are equal,
- * it returns `that` (the second argument). It does not mutate either argument.
+ * it returns `that` (the second argument).
  *
  * **Example** (maximum of two numbers)
  *
@@ -248,8 +248,7 @@ export function max<A>(order: Order.Order<A>): Combiner<A> {
  *
  * **Details**
  *
- * `combine(self, that)` returns `self` and ignores `that`. The second argument
- * is discarded, not mutated.
+ * `combine(self, that)` returns `self` and ignores `that`.
  *
  * **Example** (keeping the first value)
  *
@@ -280,8 +279,7 @@ export function first<A>(): Combiner<A> {
  *
  * **Details**
  *
- * `combine(self, that)` returns `that` and ignores `self`. The first argument
- * is discarded, not mutated.
+ * `combine(self, that)` returns `that` and ignores `self`.
  *
  * **Example** (keeping the last value)
  *
@@ -315,7 +313,6 @@ export function last<A>(): Combiner<A> {
  * **Details**
  *
  * `combine(self, that)` returns the constant `a` and ignores both arguments.
- * No mutation occurs.
  *
  * **Example** (always returning zero)
  *
@@ -351,8 +348,7 @@ export function constant<A>(a: A): Combiner<A> {
  *
  * `intercalate(middle)(combiner).combine(self, that)` is equivalent to
  * `combiner.combine(self, combiner.combine(middle, that))`. This function is
- * curried: first provide the separator, then the base combiner. It returns a
- * new combiner and does not mutate the input combiner.
+ * curried: first provide the separator, then the base combiner.
  *
  * **Example** (joining strings with a separator)
  *

package/src/Config.ts

@@ -111,7 +111,7 @@ const TypeId = "~effect/Config"
 export const isConfig = (u: unknown): u is Config<unknown> => Predicate.hasProperty(u, TypeId)
 
 /**
- * The error type produced when config loading or validation fails.
+ * Represents the error type produced when config loading or validation fails.
  *
  * **When to use**
  *
@@ -196,8 +196,7 @@ const Proto = {
  * **When to use**
  *
  * Use to build a custom config that cannot be expressed with {@link schema} or
- *   the convenience constructors.
- * - Composing configs programmatically.
+ * convenience constructors, or to compose configs programmatically.
  *
  * **Details**
  *
@@ -420,7 +419,7 @@ export const mapOrFail: {
 })
 
 /**
- * Falls back to another config when parsing fails with a `ConfigError`.
+ * Provides a fallback config when parsing fails with a `ConfigError`.
  *
  * **When to use**
  *
@@ -452,7 +451,7 @@ export const mapOrFail: {
  */
 export const orElse: {
   /**
-   * Falls back to another config when parsing fails with a `ConfigError`.
+   * Provides a fallback config when parsing fails with a `ConfigError`.
    *
    * **When to use**
    *
@@ -484,7 +483,7 @@ export const orElse: {
    */
   <A2>(that: (error: ConfigError) => Config<A2>): <A>(self: Config<A>) => Config<A2 | A>
   /**
-   * Falls back to another config when parsing fails with a `ConfigError`.
+   * Provides a fallback config when parsing fails with a `ConfigError`.
    *
    * **When to use**
    *
@@ -1005,7 +1004,7 @@ export const TrueValues = Schema.Literals(["true", "yes", "on", "1", "y"])
 export const FalseValues = Schema.Literals(["false", "no", "off", "0", "n"])
 
 /**
- * A `Schema.Codec` for boolean values encoded as strings.
+ * Schema for boolean values encoded as strings.
  *
  * **When to use**
  *
@@ -1033,7 +1032,7 @@ export const Boolean = Schema.Literals([...TrueValues.literals, ...FalseValues.l
 )
 
 /**
- * A `Schema.Codec` for port numbers (integers in 1–65535).
+ * Schema for port numbers (integers in 1–65535).
  *
  * **When to use**
  *
@@ -1048,7 +1047,7 @@ export const Boolean = Schema.Literals([...TrueValues.literals, ...FalseValues.l
 export const Port = Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 65535 }))
 
 /**
- * A `Schema.Codec` for `LogLevel` string literals.
+ * Schema for `LogLevel` string literals.
  *
  * **When to use**
  *
@@ -1068,7 +1067,7 @@ export const Port = Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 655
 export const LogLevel = Schema.Literals(LogLevel_.values)
 
 /**
- * A `Schema.Codec` for key-value record types that can also be parsed from
+ * Schema for key-value record types that can also be parsed from
  * a flat comma-separated string.
  *
  * **When to use**

package/src/ConfigProvider.ts

@@ -146,7 +146,7 @@ export type Node =
  *
  * **Details**
  *
- * The function does not mutate input and returns a new plain object.
+ * The function returns a new plain object.
  *
  * **Example** (Creating a value node)
  *
@@ -360,7 +360,7 @@ export interface ConfigProvider extends Pipeable {
 }
 
 /**
- * The `ConfigProvider` service reference, registered in the context with a
+ * Context reference for the active raw configuration provider, registered in the context with a
  * default value of `fromEnv()`. Because it is a `Context.Reference`, it is
  * available without explicit provision; `Config` schemas automatically resolve
  * it.
@@ -868,8 +868,8 @@ export const nested: {
 )
 
 /**
- * Installs a `ConfigProvider` as the active provider for all downstream
- * effects, replacing any previously installed provider.
+ * Provides a layer that installs a `ConfigProvider` as the active provider for
+ * all downstream effects, replacing any previously installed provider.
  *
  * **When to use**
  *