12.09.2014, 17:44
|
|
Профессор
|
|
Регистрация: 23.12.2013
Сообщений: 1,856
|
|
Aetae,
штука в том, что я не знаю для чего мне нужны юзерскрипты, просто нет таких задачь, для которых они могли бы пригодиться.
Ах да, и ещё нужно заставить себя документировать код в JSDoc формате и научиться писать тесты.
----
Как вы создаёте документацию? Или вообще без неё обходитесь?
//Сам сейчас мучаю JSDoc.
|
|
12.09.2014, 17:51
|
|
Быдлокодер;)
|
|
Регистрация: 19.11.2010
Сообщений: 4,338
|
|
Цитата:
|
Как вы создаёте документацию? Или вообще без неё обходитесь?
//Сам сейчас мучаю JSDoc.
|
Много лет пытался генерить доку по jsDoc, но в итоге понял что это говно, т.к. дока либо слишком скудная, либо приходится писать поэмы в коде. Сейчас пишу руками.
jsDoc юзаю для автокомплита в IDE и компиляции GCC.
|
|
12.09.2014, 17:55
|
|
Профессор
|
|
Регистрация: 23.12.2013
Сообщений: 1,856
|
|
Aetae,
Цитата:
|
(это если конечно нет серьёзного проекта, на котором можно было бы всё испытать)
|
Нет, серьёзного проекта пока нет.
kobezzza,
Цитата:
|
Гм, для галпа я хз. Но для CLI да, а что за ошибку кидает?
|
Прикрепил скриншот.
----
И вот ещё вопрос. У меня пробный проектик со всеми плагинами Ноды(Галп + его_плагины + JSDoc) весит 23Мб, а файлов 6893. Это как-то дофига файлов.. Как вы решаете данную проблему(слышал краем уха о линковке какой-то, но её не рекомендовали делать, кажется)? Или это вообще для вас не проблема?
|
|
12.09.2014, 17:59
|
|
Быдлокодер;)
|
|
Регистрация: 19.11.2010
Сообщений: 4,338
|
|
Цитата:
|
Прикрепил скриншот.
|
А на каком коде падает?
Цитата:
|
. У меня пробный проектик со всеми плагинами Ноды(Галп + его_плагины + JSDoc) весит 23Мб, а файлов 6893.
|
Это проблема NPM, т.к. каждый модуль тянет свои зависимости отдельно. Линковать можно, но только если не вручную - сам не пробывал, пока проблема на этапе "забил и юзаю как есть".
|
|
12.09.2014, 17:59
|
|
Профессор
|
|
Регистрация: 23.12.2013
Сообщений: 1,856
|
|
kobezzza,
Цитата:
|
Много лет пытался генерить доку по jsDoc, но в итоге понял что это говно, т.к. дока либо слишком скудная, либо приходится писать поэмы в коде. Сейчас пишу руками.
|
Но ведь в любом случае придётся писать много комментов в коде или в отдельных файлах. Почему бы просто при сборке не формировать два файла - один в jsdoc, а другой без комментов?
|
|
12.09.2014, 18:02
|
|
Быдлокодер;)
|
|
Регистрация: 19.11.2010
Сообщений: 4,338
|
|
Цитата:
|
Но ведь в любом случае придётся писать много комментов в коде или в отдельных файлах. Почему бы просто при сборке не формировать два файла - один в jsdoc, а другой без комментов?
|
https://github.com/kobezzza/Collecti...rEach.es6#L199
Не малый объём текста, но тем ни менее это очень сухая дока, а если добавить нормальное howto с примерами, то текста станет раза 2-3 больше. Раньше я так и делал, но потом понял, что кроме попоболи профита нет и забил.
|
|
12.09.2014, 18:02
|
|
Профессор
|
|
Регистрация: 23.12.2013
Сообщений: 1,856
|
|
kobezzza,
Цитата:
|
Это проблема NPM, т.к. каждый модуль тянет свои зависимости отдельно.
|
Да, вот по этому не люблю, когда плагины тянут другие плагины, а те в свою очередь ещё одни, а потом ещё и ещё..
Не слышно, собираются ли авторы NPM это как-то исправлять?
|
|
12.09.2014, 18:05
|
|
Тлен
|
|
Регистрация: 02.01.2010
Сообщений: 6,585
|
|
Сообщение от Safort
|
Aetae,
штука в том, что я не знаю для чего мне нужны юзерскрипты, просто нет таких задачь, для которых они могли бы пригодиться.
|
Фи, конформист. У меня на каждом сайте по юзерскрипту. Где правит вёрстку, где добавляет удобные кнопки для работы с текстом, статьями итд, где сокращает кол-во кликов и многое другое.
Короче у меня свой тёплый и ламповый интернет.)
__________________
29375, 35
|
|
12.09.2014, 18:06
|
|
Быдлокодер;)
|
|
Регистрация: 19.11.2010
Сообщений: 4,338
|
|
Цитата:
|
Не слышно, собираются ли авторы NPM это как-то исправлять?
|
Да я за NPM как то не особо слежу, так что хз, но если сделают, то только порадуюсь
|
|
12.09.2014, 18:10
|
sinistral
|
|
Регистрация: 28.03.2011
Сообщений: 5,418
|
|
Сообщение от kobezzza
|
Это проблема NPM
|
вряд ли прямо таки проблема) это то, что делает его таким устойчивым к переменам.
Сообщение от Safort
|
Не слышно, собираются ли авторы NPM это как-то исправлять?
|
зачем исправлять то, что работает как часы
|
|
|
|