angular / angular/angular-cli

Generate documentation for default builders

Abierto
#23,088 7 comentarios 1 reacción 0 asignados Ver en GitHub
area: @angular-devkit/build-angular area: docs
Lenguaje dominante
TypeScript
Estrellas
27k
Forks
11.8k
Merge medio
14 h 23 min
PR fusionados (30 d)
162

Descripción

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.

Guía de contribución

Abrir la guía de contribución

Línea de trabajo

Comienza con la página de configuración del espacio de trabajo de AIO y el esquema predeterminado del builder enlazado, packages/angular_devkit/build_angular/src/builders/browser/schema.json. Rastrea cómo se podrían procesar los archivos de esquema para convertirlos en páginas de documentación y enlazarlas desde la lista de builders predeterminados. Se considera completado cuando cada builder relevante tenga una página generada comprensible y la configuración del espacio de trabajo enlace a esas páginas en lugar de hacerlo directamente a los esquemas JSON.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
angular, typescript
Área
build-system, documentation
Tipo de issue
Documentación
Dificultad
4/5
Tiempo estimado
3-5 días
Estado de actividad
Estancado
Claridad
Bastante claro
Aptitud para principiantes
35/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.