diff --git a/aio/content/guide/cli-builder.md b/aio/content/guide/cli-builder.md index ab451235ff..d62d2d19b6 100644 --- a/aio/content/guide/cli-builder.md +++ b/aio/content/guide/cli-builder.md @@ -20,9 +20,9 @@ A builder handler function receives two arguments; a set of input `options` (a J The separation of concerns here is the same as with [schematics](guide/glossary#schematic), which are used for other CLI commands that touch your code (such as `ng generate`). -* Options are given by the CLI user, context is provided by and provides access to the CLI Builder API, and the developer provides the behavior. +* The `options` object is provided by the CLI user, while the `context` object is provided by the CLI Builder API. -* The `BuilderContext` object provides access to the scheduling method, `BuilderContext.scheduleTarget()`. The scheduler executes the builder handler function with a given [target configuration](guide/glossary#target). +* In addition to the contextual information, the `context` object, which is an instance of the `BuilderContext`, also provides access to a scheduling method, `BuilderContext.scheduleTarget()`. The scheduler executes the builder handler function with a given [target configuration](guide/glossary#target). The builder handler function can be synchronous (return a value) or asynchronous (return a Promise), or it can watch and return multiple values (return an Observable). The return value or values must always be of type `BuilderOutput`.