Comments 34
Очень рад появлению вашего проекта.
Большое спасибо. Как только в markdown-js внедрят поддержку GFM, начну использовать!
Большое спасибо. Как только в markdown-js внедрят поддержку GFM, начну использовать!
Можно им помочь внедрить GFM, действительно нужная фича ;)
Завтра интегрирую работу @gjtorikian и отправлю PRq (см. github.com/evilstreak/markdown-js/issues/41).
Что означает сокращение GFM?
UFO just landed and posted this here
GitHub Flavored Markdown github.github.com/github-flavored-markdown/
github.com/isaacs/github-flavored-markdown
npm install github-flavored-markdown
попробовал заинтрегрировать — выглядит неплохо, надо проверить на большем числе проектов, может на него и перейдем.
npm install github-flavored-markdown
попробовал заинтрегрировать — выглядит неплохо, надо проверить на большем числе проектов, может на него и перейдем.
UFO just landed and posted this here
js
UFO just landed and posted this here
Как насчет такого преимущества, что документации может и не быть для того, чтобы проект был успешно распарсен? В этом случае может быть получена оценка покрытия документацией — цифра которая должна прибавить мотивации документировать проект.
Ну и в догонку, хоть я и не использовал Doxygen, зайдя на их сайт понял что не так-то просто будет это сделать. А тут идея такая, что лишних телодвижений не надо — один GET, и получи документацию.
Ну и в догонку, хоть я и не использовал Doxygen, зайдя на их сайт понял что не так-то просто будет это сделать. А тут идея такая, что лишних телодвижений не надо — один GET, и получи документацию.
Всё хорошо, только вот разработчиков на нод не сыщешь. Коммунити вокруг этого ф-ка действительно не хватает.
Комьюнити есть! Твиттер, гуглогруппы и гитхаб довольно активны. Сказать по правде, я ожидал большего хабр-эффекта. После ретвита @tjholowaychuk гугланалитикс показывал под сотню посетителей единовременно, а сейчас — макс 20. Видимо тема nodejs не сильно популярна среди хабражителей :)
Но на гитхабе и в группах приходится общаться много, и надо отдать должное комьюнити — в основном разработчики очень отзывчивы.
Но на гитхабе и в группах приходится общаться много, и надо отдать должное комьюнити — в основном разработчики очень отзывчивы.
Этот инструмент можно использовать не только для документирования Node.js проектов.
Да ладно? Может, условия вакансии не ахти? Есть, кстати, неплохая группа в Facebook, — MoscowJS.
Условия нормальные. Большинство задает вопрос: «А че это?». А разработка под мобильные еще больше сужает круг поиска. За ссылку спс, пошукаем. Мб еще есть какие ресурсы? Желательно на русском.
Раньше использовал jsdoc-toolkit
Планируете ли вы использовать этот генератор для других языков?
А зачем? Для Ruby естественен YARD или Tomdoc.
Другое дело, что нужна поддержка C extensions.
Другое дело, что нужна поддержка C extensions.
Да, я в основном о них.
Думаю вы помните историю со взлётом Dox и знаете чем он закончил в итоге. Так что продолжаю вынашивать эту мысль.
P.S. На самом деле, думаю что можно организовать всё это дело так, чтобы можно было поддерживать любой язык. Тем более что кроме расширений есть ещё и кофескрипт.
Думаю вы помните историю со взлётом Dox и знаете чем он закончил в итоге. Так что продолжаю вынашивать эту мысль.
P.S. На самом деле, думаю что можно организовать всё это дело так, чтобы можно было поддерживать любой язык. Тем более что кроме расширений есть ещё и кофескрипт.
UFO just landed and posted this here
Кстати, если генератор станет умнее, возможно стоит попробовать объединиться с startic.kr/njs, авто как раз планирует делать генерацию документации там.
Поумнеть генератору поможет фидбэк в виде проектов на которых в настоящий момент не очень адекватный результат. К сожалению не все в моих силах. Например, в случае с backbone.js может справиться только docco, потому что там такая архитектура файла.
Кстати, проект переехал на jsdoc.info
Кстати, проект переехал на jsdoc.info
Sign up to leave a comment.
Онлайн генератор документации для Node.JS проектов