Документирование проектов #511583

Собственно вопрос, кто чем пользуется и как документирует проекты, в частности исходный код. Пользуетесь для этого сторонним софтом или просто обходитесь комментариями? И сразу второй вопрос, что бы не заводить еще одну ветку, какими инструментами пользуетесь для проектирования конфигураций и отслеживания, того что сделано и что еще предстоит. Если не трудно поделитесь опытом пожалуйста.

MS OneNote радует интеграция с аутглюком  и онлайн синхронизация

комментарии не оставляю, изменения не документирую и не планирую

Тех задания, утвержденные и подписанные вами и заказчиком, чтоб в случае если он будет потом кричать "какого вы мне тут понаделали?!" можно было бы спокойно ткнуть его в этот документ.Ну и самому проще становится, если все нормально расписано.:)

Сынок, это фантастика (с)

ТЗ это понятно, но я спрашиваю именно про исходный код. В ТЗ ведь не расписана структура модуля, переменные и функции.

а зачем документировать название переменных?

Ну про переменный, я так к слову. )

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

сделали свою конфу, которая генерит комментарии. Комменты затем используются в коде. На каждую заявку или проектную задачу может быть несколько изменений. По коду изменения всегда можно восстановить, кто это делал и зачем..

Все никак руки не дойдут поглядать вот это решение: вроде б для управления документацией проекта должно быть самое то. Исходный код документируется нарно как и везде: кто менял, когда менял и на основе какого задания (ссылка на задание)... По поводу планирования используем скрам методологию слегка - задания планируются только на спринт с приоритетами и трудозатратами, пишется все в какую-нить табличку - спринт-беклог, на основе гуглодока и отслеживается с помощью берндаун-диаграммы

А, проектирование конфигурации или все на бумажке и в голове?

Enterprise Architect. Нотацию разработали сами.

Любопытная штука. Правда не совсем то, что нужно.

В Enterprise Architect только рисую. Потом юзкейсы переносятся в самописку, допиливаются требованиями и генерится ТЗ.

Подниму, пожалуй.

Интересная тема!

еще б в нее писали...

Ага, все молчат.

а о чем говорить =)

вот моя прога.

а вот наша прога

Интересно. А что там за генератор документации?

Вот, два человека поделились.

а где такую взять? выглядит классно

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

в продажу поступит в конце октября. Сейчас делаем сайт, ставим защиту и проводим сертификацию "1С:Совместимо" Основные возможности: 1. Разработка плана проекта 2. Назначение задач проекта исполнителям 3. Ведение ежедневника 4. Сопоставление показателей работы: Согласовано с клиентом, запланировано внутри компании, фактически отработано 5. Подготовка релизов, оформленных по всем правилам (новое в релизе, изменения по назначениям, изменения по объектам метаданных) 6. Ведение взаиморасчетов с клиентами 7. Учет премий и КТУ сотрудников Подойдет всем: от фрилансера до консалтера и франчиков =)

Ну этапы проекта, варианты использования и проч. описываются в прикладных объектах. На основании этого формируются доки с различными разворотами (шаблоны генератора есть на манер Enterprise Architect). Например: Дефекты ведутся отдельно от функциональных требований. Да вообще много можно придумать хорошего, ещё бы время на всё это.

любопытно. как выйдет скачаю себе.

за это еще и платить надо ?

Изменения в конфе автоматом хавает?

демка с ограничением на объем данных будет бесплатной. Ограничение рассчитано так, что бы хватило на месяц работы. Стоимость будет очень и очень разумной. нет. изменения вводяться вручную. "автохаванье" смысла не имеет, т.к. уже есть в хранилище. Здесь под изменением подразумевается законченный, связанный блок работ, имеющий один код.

Как рождаются задачи? Имею ввиду это просто отметка и планирование работ типа Project или есть зачатки Case? Моделирование там, шаблоны опросников и т.п...

В данной версии планирование типа Project По поводу CASE у нас много идей, которые мы возможно будем реализовывать в виде проектов. Зависит от интереса к текущему проекту. На базу уже разработанного продукта CASE уже ляжет очень хорошо. У нас есть свои понимания потребностей моделирования: бизнес ВИ, ВИ уровня взаимодействия с юзером, системные ВИ, модели метаданных. Можно будет строить матрицы "требования - модели", "модели - требования - задачи" и т.д.

Просто поделок типа Project валом (и все они обычно хуже Project) а Case средств со спецификой "русской разработки" нет. Разве что воруется дорогая система и настраивается под 1С, кстати вы Sparx EA купили? :))

аналогов нашей "поделки" нет. Я для себя долго искал простую систему, которая позволит свести 3 показателя в одну таблицу: Согласовано с клиентом Запланировано внутри Фактически отработано такого НЕТ. Так наша система позволяет вести учет ВСЕХ заявок и обращений. Т.е. подойдет для любого проектного или IT отдела =)

кроме того, мы не позиционируем себя как конкурент Project. Я ответил на твой вопрос, что назначения происходят примерно как в Project. Но у нас совершенно другая программа предназначенная для других целей.

Получается, если кто чем и пользуется, то в основном самописки, хотя на таком маленьком количестве людей делать выводы не очень правильно.

Да нет сейчас у нас единой культуры ведения проектов. Кто на что горазд, в лучшем случае используется ГОСТ 19, 34, а так как повелось так и пишется. каждый одеяло в свою сторону ))

а разве сначала не составляется календарный план, в котором по возможности включены все этапы проекта и примерное время выполнения?

Ага. Некоторые даже до сих пор ничего не знают о системах управления версиями.

у 1С есть попытки разработать проектную технологию. Она отражена в Проф-кейсе. Но на момент моего знакомства с ней - в разделе "проектирование" было 0 документов.