|
|
15.06.2014, 13:38
|
|
|
Регистрация: 10.07.2008
Сообщений: 3,873
|
|
|
|
|
22.06.2014, 03:28
|
|
Профессор
|
|
Регистрация: 14.03.2012
Сообщений: 1,808
|
|
Люди что за фигня? почему не показывается реклама, не догоняю... приложение релизнуто, может там хитрый выключатель есть какой то?
__________________
Научу себя плохому 
|
|
25.06.2014, 19:41
|
|
Аспирант
|
|
Регистрация: 13.06.2014
Сообщений: 36
|
|
|
Есть ли инструмент который на основе комментов в формате jsdoc в скрипте генерирует доки ?
|
|
25.06.2014, 19:47
|
 |
Быдлокодер;)
|
|
Регистрация: 19.11.2010
Сообщений: 4,338
|
|
Сообщение от cyber_2.0
|
|
Есть ли инструмент который на основе комментов в формате jsdoc в скрипте генерирует доки ?
|
http://usejsdoc.org/
https://code.google.com/p/jsdoc-toolkit/ (устаревший, рекомендуют юзать jsDoc3)
А вообще: http://habrahabr.ru/post/111861/
ЗЫ: я отказался от подхода генерации доки по jsDoc, т.к. полученная дока либо выглядит очень "скудно", а писать "поэмы" в комментах - не круто. |
|
25.06.2014, 19:59
|
|
Аспирант
|
|
Регистрация: 13.06.2014
Сообщений: 36
|
|
|
Сообщение от kobezzza
|
|
я отказался от подхода генерации доки по jsDoc
|
Ты их в ручную пишешь? |
|
25.06.2014, 21:04
|
|
Быдлокодер;)
|
|
Регистрация: 19.11.2010
Сообщений: 4,338
|
|
|
Сообщение от cyber_2.0
|
|
Ты их в ручную пишешь?
|
Да, это конечно сложно и долго, но зато качество разительно выше и код не раздувается из-за слишком больших комментариев.
Вот пример: https://github.com/kobezzza/Collecti...rEach.es6#L149 тут одного jsDoc полно, а если ещё писать полноценное описание с примерами...
Последний раз редактировалось kobezzza, 25.06.2014 в 21:10.
|
|
25.06.2014, 22:06
|
|
sinistral
|
|
Регистрация: 28.03.2011
Сообщений: 5,418
|
|
|
Сообщение от kobezzza
|
|
ЗЫ: я отказался от подхода генерации доки по jsDoc, т.к. полученная дока либо выглядит очень "скудно", а писать "поэмы" в комментах - не круто.
|
я вот думаю перебраться на github wiki. удобно более менее |
|
25.06.2014, 23:04
|
|
Быдлокодер;)
|
|
Регистрация: 19.11.2010
Сообщений: 4,338
|
|
|
Сообщение от melky
|
|
я вот думаю перебраться на github wiki. удобно более менее
|
угу, оч удобно, единственно что огорчает, что нельзя iframe там юзать в разметке, чтобы например какой нить бенчмарк или демку вкрутить, а github pages геморойнее юзать. |
|
26.06.2014, 08:49
|
|
sinistral
|
|
Регистрация: 28.03.2011
Сообщений: 5,418
|
|
|
Сообщение от kobezzza
|
|
угу, оч удобно, единственно что огорчает, что нельзя iframe там юзать в разметке, чтобы например какой нить бенчмарк или демку вкрутить, а github pages геморойнее юзать.
|
да, придётся регистрировать аккаунт на каком-нибудь codepen для выкладывания примеров) |
|
26.06.2014, 12:32
|
|
Аспирант
|
|
Регистрация: 13.06.2014
Сообщений: 36
|
|
|
Сообщение от kobezzza
|
Да, это конечно сложно и долго, но зато качество разительно выше и код не раздувается из-за слишком больших комментариев.
Вот пример: https://github.com/kobezzza/Collecti...rEach.es6#L149 тут одного jsDoc полно, а если ещё писать полноценное описание с примерами...
__________________
|
Понятно, спс. Просто так лень доки писать) |
|
|
|
