Как вы документируете свои ИС?
|
Предыдущая тема :: Следующая тема |
Автор |
Сообщение |
Perseus Участник
Вступление в Клуб: 25.02.2014
|
Ср Апр 02, 2014 09:03  Как вы документируете свои ИС? |
|
|
Добрый день! интересует вопрос - как вы документируете свои ИС? Какими методами пользуетесь? может есть какой то автоматизированный метод? знаю что шансов мало найти что то такое)) а вдруг. я новичок в pl/plus, а нужно документировать систему. может посоветуете что нибудь? |
|
 |
Alkov Профи
Вступление в Клуб: 23.09.2010
|
Ср Апр 02, 2014 09:50   |
|
|
А какая цель, просто чтобы было или есть конкретная нужда ? |
|
 |
Perseus Участник
Вступление в Клуб: 25.02.2014
|
Ср Апр 02, 2014 11:46   |
|
|
Alkov пишет: | А какая цель, просто чтобы было или есть конкретная нужда ? | ну скажем на случай смены персонала, + требование руководства |
|
 |
Random Эксперт
Вступление в Клуб: 27.06.2011
|
Чт Апр 03, 2014 06:07  Re: Как вы документируете свои ИС? |
|
|
Perseus пишет: | интересует вопрос - как вы документируете свои ИС? |
А что такое ИС? |
|
 |
Perseus Участник
Вступление в Клуб: 25.02.2014
|
Чт Апр 03, 2014 06:50  Re: Как вы документируете свои ИС? |
|
|
Random пишет: | Perseus пишет: | интересует вопрос - как вы документируете свои ИС? |
А что такое ИС? | информационные системы |
|
 |
Random Эксперт
Вступление в Клуб: 27.06.2011
|
Чт Апр 03, 2014 09:13  Re: Как вы документируете свои ИС? |
|
|
Perseus пишет: | Random пишет: | Perseus пишет: | интересует вопрос - как вы документируете свои ИС? |
А что такое ИС? | информационные системы |
Ага.
Если с точки зрения пользовательской документации, то ручками в Help And Manual.
Есть ещё проектная документация (InfoPath), новые возможности (MS Word), текстовые описания изменений (notepad) ...
код описываю комментариями в стиле javadoc.
Наверное, не помогло? |
|
 |
Perseus Участник
Вступление в Клуб: 25.02.2014
|
Чт Апр 03, 2014 09:31  Re: Как вы документируете свои ИС? |
|
|
Random пишет: | Perseus пишет: | Random пишет: | Perseus пишет: | интересует вопрос - как вы документируете свои ИС? |
А что такое ИС? | информационные системы |
Ага.
Если с точки зрения пользовательской документации, то ручками в Help And Manual.
Есть ещё проектная документация (InfoPath), новые возможности (MS Word), текстовые описания изменений (notepad) ...
код описываю комментариями в стиле javadoc.
Наверное, не помогло? | так и думал....  |
|
 |
Perseus Участник
Вступление в Клуб: 25.02.2014
|
Пн Апр 07, 2014 09:26   |
|
|
Тогда возможно ли разработать какой нибудь анализатор pl/plus кода? естественно за определенную плату. |
|
 |
Alkov Профи
Вступление в Клуб: 23.09.2010
|
Пн Апр 07, 2014 10:47   |
|
|
Perseus пишет: | Alkov пишет: | А какая цель, просто чтобы было или есть конкретная нужда ? | ну скажем на случай смены персонала, + требование руководства |
Все локальные доработки документированы в ворде, аналогично "Документация DOC" ЦФТ, т.е. операция создана по такому-то ТЗ для таких -то целей, менялась в таких-то ТЗ работает так-то. Описывает Технический писатель сразу после подготовки ТЗ по доработке на перенос + комменты ,конечно, по телу и в операции.
Архитектурно как всё развивается, к сожалению не описываем, ибо нет специального архитектора ,приходится тупо рыскать по словарю и думать об архитектуре по аналогии с имеющейся. |
|
 |
Random Эксперт
Вступление в Клуб: 27.06.2011
|
Вт Апр 08, 2014 09:23   |
|
|
Perseus пишет: | Тогда возможно ли разработать какой нибудь анализатор pl/plus кода? естественно за определенную плату. |
Разумеется, всё возможно. Непонятен результат, который хочется получить.
Что из PL+ можно получить такого, чтобы было полезно для документации? |
|
 |
Perseus Участник
Вступление в Клуб: 25.02.2014
|
Вт Апр 08, 2014 13:56   |
|
|
Random пишет: | Perseus пишет: | Тогда возможно ли разработать какой нибудь анализатор pl/plus кода? естественно за определенную плату. |
Разумеется, всё возможно. Непонятен результат, который хочется получить.
Что из PL+ можно получить такого, чтобы было полезно для документации? | в том то и дело, что нужно получить описание кода, что он делает и как... + описание схемы ТБП. в конечном итоге должен получится документ описывающий полностью работу всей БД изнутри т.е. описание пакетов, процедур и т. д. знаю, немного странно звучит, но такова задача  |
|
 |
Alexsey Эксперт
Вступление в Клуб: 06.09.2007
|
Вт Апр 08, 2014 14:04   |
|
|
Странная задача, на мой взгляд.
Сегодня система работает так. завтра концепция меняется и вы применяете ХУК.А если не дай бог еще и точку вызова повесить.
В результате все заново описывать? _________________ всегда есть как минимум 2 выхода |
|
 |
Random Эксперт
Вступление в Клуб: 27.06.2011
|
Ср Апр 09, 2014 10:08   |
|
|
Perseus пишет: | Random пишет: | Perseus пишет: | Тогда возможно ли разработать какой нибудь анализатор pl/plus кода? естественно за определенную плату. |
Разумеется, всё возможно. Непонятен результат, который хочется получить.
Что из PL+ можно получить такого, чтобы было полезно для документации? | в том то и дело, что нужно получить описание кода, что он делает и как... + описание схемы ТБП. в конечном итоге должен получится документ описывающий полностью работу всей БД изнутри т.е. описание пакетов, процедур и т. д. знаю, немного странно звучит, но такова задача  |
Знаете...
Я, когда разбираю текст операции, попавшей мне на оптимизацию, иногда трачу до недели, чтобы понять, что она делает. А я вроде как профи в своём деле.
Да, конечно, можно получить что-то вроде: "в этом месте мы увеличиваем переменную x на величину y", но вот зачем эта величина увеличивается, никакой автомат вам не скажет.
Кроме того, непонятно, для каких целей вам нужен такой анализ?
Хотите сделать что-то такое же, но своё?
Тогда учтите, что требования ЦБ меняются крайне часто, отчёты дописываются/переписываются; продуктовый функционал тоже не стоит на месте... одному это не потянуть и не угнаться. И надо разбираться в области.
А если вы разбираетесь в какой-то области, то зачем же вам такой автомат  |
|
 |
|
|
Вы не можете начинать темы Вы не можете отвечать на сообщения Вы не можете редактировать свои сообщения Вы не можете удалять свои сообщения Вы не можете голосовать в опросах
|
|