Керівництво системного програміста

Документація по супроводу ПС (system documentation) описує ПС з точки зору її розробки. Ця документація потрібна, якщо ПС припускає вивчення того, як воно влаштована (сконструйована), і модернізацію його програм. Як вже відзначалося, супровід - це тривала розробка. Тому у разі потреби модернізації ПС до цієї роботи притягується спеціальна команда розробників-супровідників. Цій команді доведеться мати справу з такою ж документацією, яка визначала діяльність команди первинних (основних) розробників ПС, - з тією лише різницею, що ця документація для команди розробників-супровідників буде, як правило, чужий (вона створювалася іншою командою). Команда розробників-супровідників повинна буде вивчати цю документацію, щоб зрозуміти будову і процес розробки модернізованого ПС, і внести в цю документацію необхідні зміни, повторюючи значною мірою технологічні процеси, за допомогою яких створювалося первинне ПС.

Документація по супроводу ПС можна розбити на дві групи:

((1) документація, що визначає будову програм і структур даних ПС і технологію їх розробки;

((2) документацію, що допомагає вносити зміни в ПС.

Документація першої групи містить підсумкові документи кожного технологічного етапу розробки ПС. Вона включає наступні документи:

Зовнішній опис ПС (Requirements document).

Опис архітектури ПС (description of the system architecture), включаючи зовнішню специфікацію кожної її програми.

Для кожної програми ПС - опис її модульної структури, включаючи зовнішню специфікацію кожного включеного в неї модуля.

Для кожного модуля - його специфікація і опис його будови (design description).

Тексти модулів на вибраній мові програмування (program source code listings).

Документи встановлення достовірності ПС (validation documents), що описують, як встановлювалася достовірність кожної програми ПС і як інформація про встановлення достовірності зв'язувалася з вимогами до ПС.

Документи встановлення достовірності ПС включають передусім документацію по тестуванню (схема тестування і опис комплекту тестів), але можуть включати і результати інших видів перевірки ПС, наприклад, докази властивостей програм.

Документація другої групи містить

Керівництво по супроводу ПС (system maintenance guide), який описує відомі проблеми разом з ПС, описує, які частини системи є аппаратно- і програмно-залежними, і як розвиток ПС врахований в його будові (конструкції).

Загальна проблема супроводу ПС - забезпечити, щоб усі його представлення йшли в ногу (залишалися узгодженими), коли ПС змінюється. Щоб цьому допомогти, зв'язки і залежності між документами і їх частинами мають бути зафіксовані в базі даних управління конфігурацією.

Дата добавления: 2014-01-04