angular / angular/angular-cli

Generate documentation for default builders

Ouverte
#23,088 7 commentaires 1 réaction 0 personnes assignées Voir sur GitHub
area: @angular-devkit/build-angular area: docs
Langage dominant
TypeScript
Étoiles
27k
Forks
11.8k
Merge moyen
14 h 23 min
PR mergées (30 j)
162

Description

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.

Guide de contribution

Ouvrir le guide de contribution

Piste de recherche

Commencez par la page de configuration de l’espace de travail AIO et le schéma par défaut du builder associé, packages/angular_devkit/build_angular/src/builders/browser/schema.json. Suivez comment les fichiers de schéma pourraient être traités pour produire des pages de documentation et être liés depuis la liste des builders par défaut. Le travail est considéré comme terminé lorsque chaque builder pertinent dispose d’une page générée compréhensible et que la configuration de l’espace de travail pointe vers ces pages au lieu de pointer directement vers les schémas JSON.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
angular, typescript
Domaine
build-system, documentation
Type d'issue
Documentation
Difficulté
4/5
Temps estimé
3-5 jours
Activité
À l'abandon
Clarté
Plutôt claire
Accessibilité débutants
35/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.