Переключение на Главную Страницу Страницы: 1 ОтправитьПечать
Обычная тема документирование кода 1С в стиле ГенераторовДокументации (число прочтений - 3231 )
lustin
1c++ power user
Отсутствует


1C *.*, ROR, Java - на
этом остановимся

Сообщений: 907
Местоположение: Москва
Зарегистрирован: 20. Октября 2006
Пол: Мужской
документирование кода 1С в стиле ГенераторовДокументации
06. Апреля 2010 :: 13:10
Печать  
уже около 2 недель пишу одну разработку в стиле РазработкаЧерезТестирование (по совету Артура)

причем стараюсь лучше больше времени потратить, но методологию соблюсти - результат кстати есть и даже положительный Подмигивание

но суть не в этом:

учитывая что проект у меня разделился на две части:

1. библиотека (набор функционала/классов)
2. обработка для реализации задачи на основе библиотеки

очень хочется библиотеку выделить в отдельный проект - и документировать функции и процедуры
однако хочется документировать так,  чтобы можно было посмотреть в виде отдельного html, chm и т.д.

путем нехитрого "гугления" пришел к выводу что нужны Генераторы документации

отсюда возникают два вопроса:

первый: использует ли кто-нибудь для документирования кода 1С вышеозначенный генераторы ?

и второй
Цитата:
Doxygen генерирует документацию на основе набора исходных текстов и также может быть настроен для извлечения структуры программы из недокументированных исходных кодов. Возможно составление графов зависимостей программных объектов, диаграмм классов и исходных кодов с гиперссылками

применительно к Doxygen, я пытаюсь разобраться, как настроить его на 1С-овский недокументированный код (для извлечения структуры зависимостей) - ни кто не пытался такое осуществить ?

ЗЫ Для любопытствующих - библиотека в разработке: это аналог на 1С вот этого
  

бизнес-процесс как техническое задание прекрасно, только у бизнеса нет процессов; у бизнеса есть желание выжить
Наверх
GTalkSkype/VoIPICQ  
IP записан
 
artbear
1c++ developer
1c++ moderator
Отсутствует


Эх, дайте что-нибудь новенькое
да полезное потести

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: документирование кода 1С в стиле ГенераторовДокументации
Ответ #1 - 06. Апреля 2010 :: 13:50
Печать  
lustin писал(а) 06. Апреля 2010 :: 13:10:
уже около 2 недель пишу одну разработку в стиле РазработкаЧерезТестирование (по совету Артура)

причем стараюсь лучше больше времени потратить, но методологию соблюсти - результат кстати есть и даже положительный Подмигивание

ОФФ Кстати, где-то читал, что опытные товарищи советуют неделю работать только на чистом TDD, а потом от TDD уже не оттащишь Улыбка
  

OpenConf developer :: http://openconf.1cpp.ru&&FormEx developer :: http://formex.dorex.ru&&1C++ active developer && tester :: www.1cpp.ru
Наверх
GTalkSkype/VoIPICQ  
IP записан
 
lustin
1c++ power user
Отсутствует


1C *.*, ROR, Java - на
этом остановимся

Сообщений: 907
Местоположение: Москва
Зарегистрирован: 20. Октября 2006
Пол: Мужской
Re: документирование кода 1С в стиле ГенераторовДокументации
Ответ #2 - 06. Апреля 2010 :: 13:53
Печать  
artbear писал(а) 06. Апреля 2010 :: 13:50:
lustin писал(а) 06. Апреля 2010 :: 13:10:
уже около 2 недель пишу одну разработку в стиле РазработкаЧерезТестирование (по совету Артура)

причем стараюсь лучше больше времени потратить, но методологию соблюсти - результат кстати есть и даже положительный Подмигивание

ОФФ Кстати, где-то читал, что опытные товарищи советуют неделю работать только на чистом TDD, а потом от TDD уже не оттащишь Улыбка


ОФФ Артур, мне так понравилось "шо п.пец" - порядку как то больше стало. стабильное и красивое решение выходит - и утром прихожу, тесты прогоняю - не падает значит все идет по плану.
  

бизнес-процесс как техническое задание прекрасно, только у бизнеса нет процессов; у бизнеса есть желание выжить
Наверх
GTalkSkype/VoIPICQ  
IP записан
 
fez
Forum Administrator
1c++ power user
Отсутствует


I wanted to cry, but the
tears wouldn't come

Сообщений: 2712
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: документирование кода 1С в стиле ГенераторовДокументации
Ответ #3 - 06. Апреля 2010 :: 14:11
Печать  
artbear писал(а) 06. Апреля 2010 :: 13:50:
lustin писал(а) 06. Апреля 2010 :: 13:10:
уже около 2 недель пишу одну разработку в стиле РазработкаЧерезТестирование (по совету Артура)

причем стараюсь лучше больше времени потратить, но методологию соблюсти - результат кстати есть и даже положительный Подмигивание

ОФФ Кстати, где-то читал, что опытные товарищи советуют неделю работать только на чистом TDD, а потом от TDD уже не оттащишь Улыбка

TDD - это очень тяжелый наркотик. Вот сижу и думаю, как бы подсадить кого?
  
Наверх
www  
IP записан
 
artbear
1c++ developer
1c++ moderator
Отсутствует


Эх, дайте что-нибудь новенькое
да полезное потести

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: документирование кода 1С в стиле ГенераторовДокументации
Ответ #4 - 06. Апреля 2010 :: 14:19
Печать  
fez писал(а) 06. Апреля 2010 :: 14:11:
artbear писал(а) 06. Апреля 2010 :: 13:50:
lustin писал(а) 06. Апреля 2010 :: 13:10:
уже около 2 недель пишу одну разработку в стиле РазработкаЧерезТестирование (по совету Артура)

причем стараюсь лучше больше времени потратить, но методологию соблюсти - результат кстати есть и даже положительный Подмигивание

ОФФ Кстати, где-то читал, что опытные товарищи советуют неделю работать только на чистом TDD, а потом от TDD уже не оттащишь Улыбка

TDD - это очень тяжелый наркотик. Вот сижу и думаю, как бы подсадить кого?

Нас можешь еще сильнее подсадить Улыбка
  

OpenConf developer :: http://openconf.1cpp.ru&&FormEx developer :: http://formex.dorex.ru&&1C++ active developer && tester :: www.1cpp.ru
Наверх
GTalkSkype/VoIPICQ  
IP записан
 
artbear
1c++ developer
1c++ moderator
Отсутствует


Эх, дайте что-нибудь новенькое
да полезное потести

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: документирование кода 1С в стиле ГенераторовДокументации
Ответ #5 - 06. Апреля 2010 :: 14:20
Печать  
lustin писал(а) 06. Апреля 2010 :: 13:53:
artbear писал(а) 06. Апреля 2010 :: 13:50:
lustin писал(а) 06. Апреля 2010 :: 13:10:
уже около 2 недель пишу одну разработку в стиле РазработкаЧерезТестирование (по совету Артура)

причем стараюсь лучше больше времени потратить, но методологию соблюсти - результат кстати есть и даже положительный Подмигивание

ОФФ Кстати, где-то читал, что опытные товарищи советуют неделю работать только на чистом TDD, а потом от TDD уже не оттащишь Улыбка


ОФФ Артур, мне так понравилось "шо п.пец" - порядку как то больше стало. стабильное и красивое решение выходит - и утром прихожу, тесты прогоняю - не падает значит все идет по плану.

Я это понял при работе над 1С++ в режиме TDD Улыбка
  

OpenConf developer :: http://openconf.1cpp.ru&&FormEx developer :: http://formex.dorex.ru&&1C++ active developer && tester :: www.1cpp.ru
Наверх
GTalkSkype/VoIPICQ  
IP записан
 
artbear
1c++ developer
1c++ moderator
Отсутствует


Эх, дайте что-нибудь новенькое
да полезное потести

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: документирование кода 1С в стиле ГенераторовДокументации
Ответ #6 - 06. Апреля 2010 :: 14:22
Печать  
artbear писал(а) 06. Апреля 2010 :: 14:19:
fez писал(а) 06. Апреля 2010 :: 14:11:
artbear писал(а) 06. Апреля 2010 :: 13:50:
lustin писал(а) 06. Апреля 2010 :: 13:10:
уже около 2 недель пишу одну разработку в стиле РазработкаЧерезТестирование (по совету Артура)

причем стараюсь лучше больше времени потратить, но методологию соблюсти - результат кстати есть и даже положительный Подмигивание

ОФФ Кстати, где-то читал, что опытные товарищи советуют неделю работать только на чистом TDD, а потом от TDD уже не оттащишь Улыбка

TDD - это очень тяжелый наркотик. Вот сижу и думаю, как бы подсадить кого?

Нас можешь еще сильнее подсадить Улыбка

Давай быстрее обработку по тестированию допиливать Улыбка
  

OpenConf developer :: http://openconf.1cpp.ru&&FormEx developer :: http://formex.dorex.ru&&1C++ active developer && tester :: www.1cpp.ru
Наверх
GTalkSkype/VoIPICQ  
IP записан
 
artbear
1c++ developer
1c++ moderator
Отсутствует


Эх, дайте что-нибудь новенькое
да полезное потести

Сообщений: 6303
Местоположение: Москва
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: документирование кода 1С в стиле ГенераторовДокументации
Ответ #7 - 26. Апреля 2010 :: 06:32
Печать  
lustin писал(а) 06. Апреля 2010 :: 13:53:
artbear писал(а) 06. Апреля 2010 :: 13:50:
lustin писал(а) 06. Апреля 2010 :: 13:10:
уже около 2 недель пишу одну разработку в стиле РазработкаЧерезТестирование (по совету Артура)

причем стараюсь лучше больше времени потратить, но методологию соблюсти - результат кстати есть и даже положительный Подмигивание

ОФФ Кстати, где-то читал, что опытные товарищи советуют неделю работать только на чистом TDD, а потом от TDD уже не оттащишь Улыбка


ОФФ Артур, мне так понравилось "шо п.пец" - порядку как то больше стало. стабильное и красивое решение выходит - и утром прихожу, тесты прогоняю - не падает значит все идет по плану.

Кстати, тот же Бек советует - перед уходом домой вечером оставить один тест, который не проходит! Утром запускать тестирование и по непрошедшему тесту можно достаточно быстро включиться в продолжение вчерашней работы.
  

OpenConf developer :: http://openconf.1cpp.ru&&FormEx developer :: http://formex.dorex.ru&&1C++ active developer && tester :: www.1cpp.ru
Наверх
GTalkSkype/VoIPICQ  
IP записан
 
lustin
1c++ power user
Отсутствует


1C *.*, ROR, Java - на
этом остановимся

Сообщений: 907
Местоположение: Москва
Зарегистрирован: 20. Октября 2006
Пол: Мужской
Re: документирование кода 1С в стиле ГенераторовДокументации
Ответ #8 - 26. Апреля 2010 :: 08:57
Печать  
artbear писал(а) 26. Апреля 2010 :: 06:32:
lustin писал(а) 06. Апреля 2010 :: 13:53:
artbear писал(а) 06. Апреля 2010 :: 13:50:
lustin писал(а) 06. Апреля 2010 :: 13:10:
уже около 2 недель пишу одну разработку в стиле РазработкаЧерезТестирование (по совету Артура)

причем стараюсь лучше больше времени потратить, но методологию соблюсти - результат кстати есть и даже положительный Подмигивание

ОФФ Кстати, где-то читал, что опытные товарищи советуют неделю работать только на чистом TDD, а потом от TDD уже не оттащишь Улыбка


ОФФ Артур, мне так понравилось "шо п.пец" - порядку как то больше стало. стабильное и красивое решение выходит - и утром прихожу, тесты прогоняю - не падает значит все идет по плану.

Кстати, тот же Бек советует - перед уходом домой вечером оставить один тест, который не проходит! Утром запускать тестирование и по непрошедшему тесту можно достаточно быстро включиться в продолжение вчерашней работы.


совет принял... однако главному совету - найти книжку в электронном виде я уже последовал  Улыбка
  

бизнес-процесс как техническое задание прекрасно, только у бизнеса нет процессов; у бизнеса есть желание выжить
Наверх
GTalkSkype/VoIPICQ  
IP записан
 
Переключение на Главную Страницу Страницы: 1
ОтправитьПечать