angular / angular/angular-cli

Generate documentation for default builders

未關閉
#23,088 7 則留言 1 個 reaction 已指派 0 人 在 GitHub 檢視
area: @angular-devkit/build-angular area: docs
主要語言
TypeScript
星號
27k
分支
11.8k
平均合併
14 小時 23 分鐘
30 天內合併 PR
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 schema packages/angular_devkit/build_angular/src/builders/browser/schema.json 開始。追蹤如何將 schema 檔案處理成文件頁面,並從預設 builder 清單連結到這些頁面。完成的標準是每個相關 builder 都有一個易於理解的產生頁面,而且工作區設定會連結到這些頁面,而不是直接連結到 JSON schema。

由索引模型根據 Issue 內容生成。

評估

技術堆疊
angular, typescript
領域
build-system, documentation
Issue 類型
文件
難度
4/5
預估耗時
3-5 天
活躍度
停滯
描述清晰度
基本清楚
新手友好度
35/100

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。