AN
Ну можно в принципе сгенерить Докку, потом пройтись по ней и подставлять обратные линки
Size: a a a
2020 May 14
LS
да проще заюзать апи докки
LS
Александр, обратные линки не нужно ставить на этапе генерации
Это можно сделать через js
Это можно сделать через js
AM
да проще заюзать апи докки
Ну вот мне тоже кажется, что проще форкнуть Докку и допилить это, чем ковырять конечные хтмл-ки на предмет классов и айдишников у тегов джиэсиком
AN
Можно, но долго на нормальной доке
VP
htmlsingle документ вполне рабочая вещь, часто применяется.
Ни разу не видел доку к коду (по классам/пакетам) в виде одного документа.
Вот доку написанную руками - да.
Вот доку написанную руками - да.
LS
Ни разу не видел доку к коду (по классам/пакетам) в виде одного документа.
Вот доку написанную руками - да.
Вот доку написанную руками - да.
Частично сгенеренная будет.
AM
Ни разу не видел доку к коду (по классам/пакетам) в виде одного документа.
Вот доку написанную руками - да.
Вот доку написанную руками - да.
Ну я и линков на usages по документации никогда не видел, описывается явно не самый типичный случай)
VP
Частично сгенеренная будет.
Ну я к тому, что даже не представляю, как оно может адекватно выглядеть
VP
Ну я и линков на usages по документации никогда не видел, описывается явно не самый типичный случай)
Это да, хотелка специфичная
LS
Накидаю и покажу
LS
А вам самим такое не хочется?
AM
Я уже два раза писал, почему мне это кажется странным)
AM
Линки в код вроде того, что grepcode.com делает, я бы ещё понял, но там всё же не совсем о документации, оно прям целиком проекты с кодом индексирует
AN
Линки в код вроде того, что grepcode.com делает, я бы ещё понял, но там всё же не совсем о документации, оно прям целиком проекты с кодом индексирует
Линки в код и жавадок умеет
AM
А чисто по док-комментам usages, КМК, ни о чём не говорит. Но вполне возможно, что мы по-разному себе представляем то, как надо док-комменты писать.
AM
Мне дока к корутинам тем же нравится тем, что там free-form маркдаун-файлы закрывают вопрос гайдов и человеческого пояснения, оставляя док-комментам узкую роль пояснения концептов конкретных классов плюс "как это вызывать".
AM
Так что я с удовольствием посмотрел бы на то, о чём ты говоришь, и, возможно, чему-то научился бы благодаря этому :)
AM
Линки в код вроде того, что grepcode.com делает, я бы ещё понял, но там всё же не совсем о документации, оно прям целиком проекты с кодом индексирует
Кек, грепкод уже больше полутора лет как не существует))
2020 May 15
ML