<p align=right>
<i>Читайте документацию: то что вы видите&nbsp;- это все, что у вас есть</i>
<p>
Документирование&nbsp;- это традиционная головная боль любого творца. И, пожалуй, первым руководством пользователя стала Библия&nbsp;- книга, составленная различными людьми, не обновляемая уже две тысячи лет и написанная задним числом, как и всякая документация.
<p>
И хотя нынешние внедрения не столь масштабны, разработка приемлемой документации, внятно описывающей созданную информационную систему, и по сей день остаётся проблемой практически каждого серьезного разработчика.
<p>
Цель данной статьи&nbsp;- вкратце сформулировать требования, состав и структуру документации на информационную систему (ИС) а также рассмотреть решения, удовлетворяющие данным требованиям применительно к платформам V7 и V8.
<p>
Исторически именно разработчики первыми озаботились документированием своих разработок. Результатом этих усилий по наведению порядка стали стандарты документирования, базирующиеся на исходных текстах программных модулей. Однако, с ростом масштаба и комплексности ИС, акценты в документировании все больше смещаются с кода в область формализации требований, архитектуры и регламента использования системы. Таким образом, все большее значение приобретают "производные" по отношению к коду документы.
<p>
Давайте попробуем разобраться, кто же является потребителем информации о системе, какую информацию и в какой форме он хочет получать, а также из каких источников данная информация может быть ему предоставлена. <p>
В приведенной таблице по горизонтали перечислены категории потребителей информации о системе, по вертикали&nbsp; элементы документации системы, являющиеся источниками информации. Hа пересечении строк со столбцами&nbsp;– вопросы, закрываемые данным документом для данного пользователя.

Читать всю статью: http://www.klerk.ru/1c/soft/?1738