angular / angular/angular-cli

Generate documentation for default builders

Aberta
#23,088 7 comentários 1 reação 0 responsáveis Ver no GitHub
area: @angular-devkit/build-angular area: docs
Linguagem predominante
TypeScript
Estrelas
27k
Forks
11.8k
Merge médio
14h 23min
PRs com merge (30d)
162

Descrição

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.

Guia de contribuição

Abrir o guia de contribuição

Direção de pesquisa

Comece pela página de configuração do workspace AIO e pelo schema padrão do builder vinculado, packages/angular_devkit/build_angular/src/builders/browser/schema.json. Rastreie como os arquivos de schema poderiam ser processados em páginas de documentação e vinculados a partir da lista de builders padrão. O trabalho estará concluído quando cada builder relevante tiver uma página gerada compreensível e a configuração do workspace apontar para essas páginas em vez de apontar diretamente para os schemas JSON.

Escrita pelo modelo de indexação a partir do texto da issue.

Avaliação

Stack de tecnologia
angular, typescript
Domínio
build-system, documentation
Tipo de issue
Documentação
Dificuldade
4/5
Tempo estimado
3-5 dias
Status de atividade
Estagnada
Clareza
Razoavelmente clara
Facilidade para iniciantes
35/100

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.