The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]



Вариант для распечатки  
Пред. тема | След. тема 
Форум Разговоры, обсуждение новостей
Режим отображения отдельной подветви беседы [ Отслеживать ]

Оглавление

Представлен watson, инструмент для работы с уведомлениями об..., opennews (ok), 24-Ноя-13, (0) [смотреть все]

Сообщения [Сортировка по времени | RSS]


26. "Представлен watson, инструмент для работы с..."  –1 +/
Сообщение от arisu (ok), 25-Ноя-13, 21:48 
мда. что только люди не делают, лишь бы не использовать literate programming.

что характерно — в итоге получаются мегакостыли, которые превращают код в нечитаемую кашу. а многие разработчики начинают считать, что doxygen — это документация.

Ответить | Правка | Наверх | Cообщить модератору

28. "Представлен watson, инструмент для работы с..."  +/
Сообщение от Crazy Alex (ok), 25-Ноя-13, 22:11 
Ну, чистый literate programming не уверен, что применим. А так - в нужную же сторону шаг. А вот насчет доксигена - согласен. Зайдешь, глянешь - функции с классами задокументированы, а какая общая архитектура, почему так и что будет каноничным решением, а что против шерсти - только на своих шишках узнавать. как по мне - лучше бы уж наоборот. Если нормально именовать то деревья классов и IDE построит, а вот high level overview ты из неё никак не выдерешь... С другой стороны - чтобы его написать оно должно, как минимум, быть в голове у разработчика.
Ответить | Правка | Наверх | Cообщить модератору

29. "Представлен watson, инструмент для работы с..."  +/
Сообщение от arisu (ok), 25-Ноя-13, 22:40 
это ужасный шаг. это такой доксиген, только для трекера. фигня-фигня-фигня-фигня.

дело в том, что задачи, которые тривиальней одной строчки, в коде описывать и замахаешься, и намусоришь изрядно. а однострочники — им место совсем в другом месте. :3 это раз.

два: в коде отсутствует ссылка на багтрекер. что делать? иди, ищи, куда и что оно там занесло.

три: в код не приходят комментарии, уточнения и ты пы. иди, ищи.

да вообще, глупость. не надо, совсем не надо использовать код в качестве хранилища всего-всего. получается свалка фигни.

и вообще: зачем столько хайпа вокруг того, что реализуется наипримитивнейшими скриптами в любом нормальном редакторе?

фу такими быть.

Ответить | Правка | Наверх | Cообщить модератору

30. "Представлен watson, инструмент для работы с..."  +/
Сообщение от Crazy Alex (ok), 25-Ноя-13, 23:50 
Скажем так - это лучше, чем когда документация в одном месте, багтрекер в другом, код в третьем. Тут хотя бы issues ходят рядом с кодом, а в [todo] можно воткнуть see issues/xxx for details.

А хайпа много потому чо вроде вот оно наипримитивнейшими скриптами развивается, а по факту - нигде нет. Может, проект замутить - эдакое "всё в одном" для открытых проектов на базе гита, с формированием на основе этого дела статического сайта? Чтобы от issue tracker до генерации бинарников.

Ответить | Правка | Наверх | Cообщить модератору

31. "Представлен watson, инструмент для работы с..."  +/
Сообщение от arisu (ok), 26-Ноя-13, 00:00 
> Скажем так - это лучше, чем когда документация в одном месте, багтрекер
> в другом, код в третьем.

а что поменялось-то? документация по-прежнему в одном, багтрекер в другом, код в третьем.

Ответить | Правка | Наверх | Cообщить модератору

32. "Представлен watson, инструмент для работы с..."  +/
Сообщение от Crazy Alex (ok), 26-Ноя-13, 00:37 
так здесь багтрекер генерится из кода, насколько я понимаю
Ответить | Правка | Наверх | Cообщить модератору

33. "Представлен watson, инструмент для работы с..."  +/
Сообщение от arisu (ok), 26-Ноя-13, 00:44 
> так здесь багтрекер генерится из кода, насколько я понимаю

и? что потом с ним делать? иметь, пардон май фрэнч?

Ответить | Правка | Наверх | Cообщить модератору

35. "Представлен watson, инструмент для работы с..."  +/
Сообщение от Crazy Alex (ok), 27-Ноя-13, 16:06 
Видеть состояние независимо от любых внешних багтрекеров, вестимо.
Ответить | Правка | Наверх | Cообщить модератору

36. "Представлен watson, инструмент для работы с..."  +/
Сообщение от arisu (ok), 28-Ноя-13, 00:48 
> Видеть состояние независимо от любых внешних багтрекеров, вестимо.

лол. чего состояние-то? ну ок, я взял код. а потом в багтрекер написал. откуда в коде возьмётся изменения состояния — это раз. и два: а если принесут — за это надо убивать.

перестань ты уже. дубовая это идея, дубовая. это то же самое, что и «приложения в браузере» — натягивание совы на глобус.

то, что связь трекеров и документации с кодом удобна — факт. то, что это невозможно нормально реализовать средствами «чистого текста» (так, чтобы и связи не ломались, и не мешали, и *удобно* редактировать можно было в любом редакторе чистого текста) — тоже факт. вот и начинают пытаться использовать инструменты не по назначению.

я уже неоднократно говорил: нужен универсальный движок «составных» документов, на том же уровне, на котором glibc живёт. и API как типа fgetc() для тех, кому неинтересно форматирование и «не-буквы», так и посложнее (в том числе с возможностью редактирования документа без переписывания всего файла) для тех, кому нужны расширеные возможности. даже эмулятор fread() можно поверх сделать, который будет тупо буквы вытаскивать.

и вот когда это появится — тогда счастье из «прекрасного далёка» переместится на расстояние протянутой руки. а до тех пор мы будем продолжать слышать из разных концов планеты вопли сов, которым в задницы пихают глобусы.

Ответить | Правка | Наверх | Cообщить модератору

Архив | Удалить

Рекомендовать для помещения в FAQ | Индекс форумов | Темы | Пред. тема | След. тема




Партнёры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру