Dartdoc: ссылка на идентификаторы в sdk на api.dartlang.org из стороннего пакета

Созданный на 28 июл. 2015  ·  8Комментарии  ·  Источник: dart-lang/dartdoc

Поддержка ссылок на идентификаторы (например, List ) SDK. Ссылки могут быть добавлены к типам в подписях (класс, метод, ...) и в комментариях документа ( ссылки разметки ).

P1 customer angular enhancement help wanted

Все 8 Комментарий

Есть новости по этому поводу? Можно ли его отсортировать и пометить уровнем приоритета, скажем, P1 :)

@devoncarew, у нас еще кто-то работает над дартдоком?

@keertip работает над этим, но это не ее основная задача; здесь приветствуются взносы.

@devoncarew - Спасибо за обновление. Можем ли мы хотя бы присвоить этому вопросу уровень приоритета?
И, может быть, пометить его как помощь ?

Это запрос на внешнюю связь с api.dartlang.org или запрос на автоматическое включение зависимостей для этого?

Думаю, первое.

Я считаю, что это запрос на созданный извне документ API, который по умолчанию использует классы SDK для связи с документом SDK. Например, если внешний пакет (скажем, args ) имеет свойство Map (скажем, команды ), большинство людей захотят щелкнуть Map и перейти на https://api.dartlang.org/stable/dart-core. /Map-class.html.

Возможны следующие варианты: (1) не создавать эти ссылки или (2) ссылаться на определенную версию документации SDK API. Эти ссылки, вероятно, должны иметь форматирование по умолчанию, отличное от ссылок внутри того же пакета.

ХОРОШО. # 1368 адресован второму, хотя первый определенно на моем радаре. Собираюсь скорректировать название вопроса, чтобы было понятнее.

1524 должен сделать это намного проще. У Dartdoc теперь есть элементарная осведомленность о границах пакета, которую мы можем использовать, чтобы определить, должны ли создаваться альтернативные гиперссылки, так что теперь это просто вопрос реализации генерации.

Была ли эта страница полезной?
0 / 5 - 0 рейтинги