Dartdoc: lien vers les identifiants dans le sdk sur api.dartlang.org à partir d'un package tiers

Créé le 28 juil. 2015  ·  8Commentaires  ·  Source: dart-lang/dartdoc

Support des liens vers les identifiants (par exemple List ) du sdk. Des liens devraient être ajoutés aux types de signatures (classe, méthode, ...) et aux commentaires de la doc ( liens de balisage ).

P1 customer angular enhancement help wanted

Tous les 8 commentaires

Une mise à jour pour ceci? Pourrait-il être trié et marqué avec un niveau de priorité, disons, P1 :)

@devoncarew avons-nous encore quelqu'un qui travaille sur dartdoc ?

@keertip y travaille, mais ce n'est pas sa tâche principale ; les contributions sont les bienvenues ici.

@devoncarew - Merci pour la mise à jour. Pourrions-nous au moins attribuer un niveau de priorité à cette question ?
Et peut-être aussi l'étiqueter comme aide recherchée ?

S'agit-il d'une demande de lien externe vers api.dartlang.org ou d'une demande d'auto-include-dépendances pour le faire ?

Le premier, je pense.

Je pense qu'il s'agit d'une demande de documentation d'API générée en externe qui utilise des classes SDK pour établir un lien avec la documentation SDK, par défaut. Par exemple, si un package externe (disons, args ) a une propriété qui est une carte (disons, commandes ), la plupart des gens voudront pouvoir cliquer sur Carte et accéder à https://api.dartlang.org/stable/dart-core /Classe-carte.html.

Les options peuvent consister (1) à ne pas générer ces liens ou (2) à créer un lien vers une version particulière de la documentation de l'API SDK. Ces liens devraient probablement avoir un formatage par défaut différent des liens à l'intérieur du même package.

D'ACCORD. #1368 s'est adressé à ce dernier, le premier est définitivement sur mon radar cependant. Je vais ajuster le titre du problème pour être plus clair.

1524 devrait rendre cela beaucoup plus facile. Dartdoc a maintenant une connaissance élémentaire des limites du paquet que nous pouvons utiliser pour déterminer si des hyperliens alternatifs doivent être générés, il ne s'agit donc plus que d'implémenter la génération.

Cette page vous a été utile?
0 / 5 - 0 notes