Skip to content

Commit bd7393f

Browse files
Keen Yee Liaumatsko
authored andcommitted
docs: Mention Bazel builder and schematics in Deprecations section (angular#37190)
This commit adds Bazel builder and schematics to the global list of deprecations in Angular. A link to the migration doc is added. PR Close angular#37190
1 parent 08ff8aa commit bd7393f

File tree

2 files changed

+8
-3
lines changed

2 files changed

+8
-3
lines changed

aio/content/guide/deprecations.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,7 @@ v9 - v12
3535

3636
| Area | API or Feature | May be removed in |
3737
| ----------------------------- | --------------------------------------------------------------------------- | ----------------- |
38+
| `@angular/bazel` | [`Bazel builder and schematics`](#bazelbuilder) | v10 |
3839
| `@angular/common` | [`ReflectiveInjector`](#reflectiveinjector) | <!--v8--> v11 |
3940
| `@angular/common` | [`CurrencyPipe` - `DEFAULT_CURRENCY_CODE`](api/common/CurrencyPipe#currency-code-deprecation) | <!--v9--> v11 |
4041
| `@angular/core` | [`CollectionChangeRecord`](#core) | <!--v7--> v11 |
@@ -160,7 +161,11 @@ Tip: In the [API reference section](api) of this doc site, deprecated APIs are i
160161

161162
This section lists all of the currently-deprecated features, which includes template syntax, configuration options, and any other deprecations not listed in the [Deprecated APIs](#deprecated-apis) section above. It also includes deprecated API usage scenarios or API combinations, to augment the information above.
162163

164+
{@a bazelbuilder}
165+
### Bazel builder and schematics
163166

167+
Bazel builder and schematics were introduced in Angular Labs to let users try out Bazel without having to manage Bazel version and BUILD files.
168+
This feature has been deprecated. For more information, please refer to the [migration doc](https://github.com/angular/angular/blob/master/packages/bazel/src/schematics/README.md).
164169

165170
{@a wtf}
166171
### Web Tracing Framework integration

packages/bazel/src/schematics/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,16 +15,16 @@ In the beginning of this project, we thought it would make Bazel easier for
1515
users to adopt if we abstracted the BUILD files management and tooling
1616
orchestration within Angular CLI. However, we have come to realize that such
1717
abstraction does not encourage users to use Bazel to its full potential.
18-
There is currently a [prototype](https://github.com/bazelbuild/rules_nodejs/tree/master/examples/angular_bazel_architect)
19-
that showcases how multiple architects within CLI could be orchestrated by Bazel.
2018

2119
There are a few other reasons for this deprecation:
2220

2321
1. Bazel ecosystem for the Web is still evolving at a rapid pace.
2422
2. The introduction of the Angular Ivy compiler enables new ways to use Bazel
2523
in a faster and more efficient manner (see below).
2624
3. Feature parity with Webpack-based Angular CLI is difficult to achieve without
27-
trade-offs that would not be acceptable for many Angular users.
25+
trade-offs that would not be acceptable for many Angular users.
26+
There is currently a [prototype](https://github.com/bazelbuild/rules_nodejs/tree/master/examples/angular_bazel_architect)
27+
that showcases how multiple architects within CLI could be orchestrated by Bazel.
2828

2929
## Migrate from `@angular/bazel`
3030

0 commit comments

Comments
 (0)