Javascript-форум (https://javascript.ru/forum/)
-   Оффтопик (https://javascript.ru/forum/offtopic/)
-   -   Обсуждений тред (https://javascript.ru/forum/offtopic/47364-obsuzhdenijj-tred.html)

Octane 15.06.2014 13:38

просто возьми готовую виртуалку https://www.modern.ie/en-us/virtualization-tools

l-liava-l 22.06.2014 03:28


Люди что за фигня? почему не показывается реклама, не догоняю... приложение релизнуто, может там хитрый выключатель есть какой то?

cyber_2.0 25.06.2014 19:41

Есть ли инструмент который на основе комментов в формате jsdoc в скрипте генерирует доки ?

kobezzza 25.06.2014 19:47

Цитата:

Сообщение от cyber_2.0 (Сообщение 318001)
Есть ли инструмент который на основе комментов в формате jsdoc в скрипте генерирует доки ?

http://usejsdoc.org/

https://code.google.com/p/jsdoc-toolkit/ (устаревший, рекомендуют юзать jsDoc3)

А вообще: http://habrahabr.ru/post/111861/

ЗЫ: я отказался от подхода генерации доки по jsDoc, т.к. полученная дока либо выглядит очень "скудно", а писать "поэмы" в комментах - не круто.

cyber_2.0 25.06.2014 19:59

Цитата:

Сообщение от kobezzza
я отказался от подхода генерации доки по jsDoc

Ты их в ручную пишешь?

kobezzza 25.06.2014 21:04

Цитата:

Сообщение от cyber_2.0 (Сообщение 318006)
Ты их в ручную пишешь?

Да, это конечно сложно и долго, но зато качество разительно выше и код не раздувается из-за слишком больших комментариев.

Вот пример: https://github.com/kobezzza/Collecti...rEach.es6#L149 тут одного jsDoc полно, а если ещё писать полноценное описание с примерами...

melky 25.06.2014 22:06

Цитата:

Сообщение от kobezzza
ЗЫ: я отказался от подхода генерации доки по jsDoc, т.к. полученная дока либо выглядит очень "скудно", а писать "поэмы" в комментах - не круто.

я вот думаю перебраться на github wiki. удобно более менее

kobezzza 25.06.2014 23:04

Цитата:

Сообщение от melky (Сообщение 318021)
я вот думаю перебраться на github wiki. удобно более менее

угу, оч удобно, единственно что огорчает, что нельзя iframe там юзать в разметке, чтобы например какой нить бенчмарк или демку вкрутить, а github pages геморойнее юзать.

melky 26.06.2014 08:49

Цитата:

Сообщение от kobezzza (Сообщение 318024)
угу, оч удобно, единственно что огорчает, что нельзя iframe там юзать в разметке, чтобы например какой нить бенчмарк или демку вкрутить, а github pages геморойнее юзать.

да, придётся регистрировать аккаунт на каком-нибудь codepen для выкладывания примеров)

cyber_2.0 26.06.2014 12:32

Цитата:

Сообщение от kobezzza
Да, это конечно сложно и долго, но зато качество разительно выше и код не раздувается из-за слишком больших комментариев.

Вот пример: https://github.com/kobezzza/Collecti...rEach.es6#L149 тут одного jsDoc полно, а если ещё писать полноценное описание с примерами...
__________________

Понятно, спс. Просто так лень доки писать)


Часовой пояс GMT +3, время: 10:00.