angular / angular/angular-cli

Generate documentation for default builders

オープン
#23,088 コメント 7 件 リアクション 1 件 担当者 0 名 GitHub で見る
area: @angular-devkit/build-angular area: docs
主要言語
TypeScript
スター
27k
フォーク
11.8k
平均マージ
14時間 23分
マージ済み PR(30日)
162

説明

AIO has a page on `angular.json` workspace configuration which lists [default builders](https://angular.io/guide/workspace-config#default-architect-builders-and-targets). Unfortunately these builders link directly to the [JSON schema](https://github.com/angular/angular-cli/blob/main/packages/angular_devkit/build_angular/src/builders/browser/schema.json), which is not very intuitive.

We should process these schema files and generate a page for each builder linked from the workspace configuration. This would make it much easier to understand `@angular-devkit/build-angular` and related builders' options.

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

AIO ワークスペース設定ページと、リンクされているデフォルト builder スキーマ packages/angular_devkit/build_angular/src/builders/browser/schema.json から始めます。スキーマファイルをドキュメントページに変換し、デフォルト builder の一覧からリンクできるようにする方法を追跡します。完了の条件は、関連する各 builder に理解しやすい生成ページがあり、ワークスペース設定から JSON スキーマへ直接リンクするのではなく、それらのページへリンクされていることです。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
angular, typescript
領域
build-system, documentation
issue の種類
ドキュメント
難易度
4/5
見積もり時間
3〜5日
活発さ
停滞
明瞭さ
おおむね明確
初心者へのやさしさ
35/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。