Ещё не досмотрел, может автор об этом говорил, но я считаю, что у каждого проекта должна быть солидная документация. По этому я за штуки вроде javadoc, jsdoc и тому подобные, которые генерируют вики из комментов. Если такие штуки недоступны, то нужно писать вики ручками (например markdown + mkdocs), а сами оп себе комменты вещь не очень нужная.
Поржал конечно с фразы "документация раздуется и улетит на орбиту". Честно говоря не согласен. Чем документация больше, тем лучше. Главное чтобы вся информация была строго структурирована и чтобы было побольше гиперссылок между разделами.
@@W_0_W есть такая проблема, когда в команду приходит человек и получает на почту гайд-бук-документацию-проекта на 500 страниц. отпугивает от работы достаточно сильно.
@@cupofcode1170 ну не знаю, мне кажется, вполне можно сравнивать эту документацию с википедией. никто ж не читает википедию всю, точно так же никто не заставляет читать документацию целиком. новичков нужно тыкать только на те разделы, с которыми им предстоит работать.
![Куда класть исходники / Григорий Петров [Python Meetup 29.05.2015]](http://i.ytimg.com/vi/xCE8qaiQylU/mqdefault.jpg)
![Куда класть исходники / Григорий Петров [Python Meetup 29.05.2015]](/img/tr.png)
Просто обожаю доклады Григория, мужик так рассказывает доходчиво и понятно, что просто заслушиваешься =)
Спасибо большое. Григорий как всегда мастерски легко говорит о сложном
Чувак на заднем плане в носу ковыряется прикольно)
Добавьте имя автора куда нибудь, а то это видео не найдется при поиске по имени автора
Спасибо! Григорий!
Да, очень приятно слушать)
Это я хорошо нашёл этот канал))
Спасибо вам за ваши видео.
Очешуетительный мужик.
Мужик помешался на этом кошельке.
а он постройнел за 8 лет
Ещё не досмотрел, может автор об этом говорил, но я считаю, что у каждого проекта должна быть солидная документация. По этому я за штуки вроде javadoc, jsdoc и тому подобные, которые генерируют вики из комментов. Если такие штуки недоступны, то нужно писать вики ручками (например markdown + mkdocs), а сами оп себе комменты вещь не очень нужная.
Поржал конечно с фразы "документация раздуется и улетит на орбиту". Честно говоря не согласен. Чем документация больше, тем лучше. Главное чтобы вся информация была строго структурирована и чтобы было побольше гиперссылок между разделами.
@@W_0_W есть такая проблема, когда в команду приходит человек и получает на почту гайд-бук-документацию-проекта на 500 страниц. отпугивает от работы достаточно сильно.
просто представь документацию к проекту, которую ты изучаешь неделю перед началом работы. это ад. это и есть проявление complexity problem.
@@cupofcode1170 ну не знаю, мне кажется, вполне можно сравнивать эту документацию с википедией. никто ж не читает википедию всю, точно так же никто не заставляет читать документацию целиком. новичков нужно тыкать только на те разделы, с которыми им предстоит работать.