Dartdoc: link para identificadores no sdk em api.dartlang.org do pacote de terceiros

Criado em 28 jul. 2015  ·  8Comentários  ·  Fonte: dart-lang/dartdoc

Links de suporte para identificadores (por exemplo List ) do SDK. Os links devem ser adicionados aos tipos em (classe-, método-, ...) assinaturas e em comentários de documentos ( links de marcação ).

P1 customer angular enhancement help wanted

Todos 8 comentários

alguma atualização disso? Poderia ser triado e marcado com um nível de prioridade, digamos, P1 :)

@devoncarew ainda temos alguém trabalhando no dartdoc?

@keertip está trabalhando nisso, mas não é sua tarefa principal; contribuições são bem-vindas aqui.

@devoncarew - Obrigado pela atualização. Podemos pelo menos atribuir um nível de prioridade a este problema?
E talvez marcá-lo como necessidade de ajuda também?

É uma solicitação de vínculo externo para api.dartlang.org ou uma solicitação de dependências de inclusão automática para fazer isso?

O primeiro, eu acho.

Acredito que seja uma solicitação de doc da API gerado externamente que usa classes do SDK para vincular ao doc do SDK, por padrão. Por exemplo, se um pacote externo (digamos, args ) tem uma propriedade que é um Mapa (digamos, comandos ), a maioria das pessoas gostaria de poder clicar em Mapa e acessar https://api.dartlang.org/stable/dart-core /Map-class.html.

As opções podem ser (1) não gerar esses links ou (2) vincular a uma versão específica dos documentos da API do SDK. Esses links provavelmente devem ter formatação padrão diferente dos links dentro do mesmo pacote.

OK. # 1368 abordou o último, o primeiro está definitivamente no meu radar. Vou ajustar o título do problema para ficar mais claro.

1524 deve tornar isso muito mais fácil. O Dartdoc agora tem algum conhecimento elementar de limite de pacote que podemos usar para determinar se hyperlinks alternativos devem ser gerados, então agora é apenas uma questão de implementar a geração.

Esta página foi útil?
0 / 5 - 0 avaliações