Керівництво системного програміста.
Документація по супроводу ПС (system documentation) описує ПС з точки зору її розробки. Ця документація потрібна, якщо ПС припускає вивчення того, як воно влаштована (сконструйована), і модернізацію його програм. Як вже відзначалося, супровід - це тривала розробка. Тому у разі потреби модернізації ПС до цієї роботи притягується спеціальна команда розробників-супровідників. Цій команді доведеться мати справу з такою ж документацією, яка визначала діяльність команди первинних (основних) розробників ПС, - з тією лише різницею, що ця документація для команди розробників-супровідників буде, як правило, чужий (вона створювалася іншою командою). Команда розробників-супровідників повинна буде вивчати цю документацію, щоб зрозуміти будову і процес розробки модернізованого ПС, і внести в цю документацію необхідні зміни, повторюючи значною мірою технологічні процеси, за допомогою яких створювалося первинне ПС.
Документація по супроводу ПС можна розбити на дві групи:
((1) документація, що визначає будову програм і структур даних ПС і технологію їх розробки;
((2) документацію, що допомагає вносити зміни в ПС.
Документація першої групи містить підсумкові документи кожного технологічного етапу розробки ПС. Вона включає наступні документи:
Зовнішній опис ПС (Requirements document).
Опис архітектури ПС (description of the system architecture), включаючи зовнішню специфікацію кожної її програми.
Для кожної програми ПС - опис її модульної структури, включаючи зовнішню специфікацію кожного включеного в неї модуля.
Для кожного модуля - його специфікація і опис його будови (design description).
Тексти модулів на вибраній мові програмування (program source code listings).
Документи встановлення достовірності ПС (validation documents), що описують, як встановлювалася достовірність кожної програми ПС і як інформація про встановлення достовірності зв'язувалася з вимогами до ПС.
Документи встановлення достовірності ПС включають передусім документацію по тестуванню (схема тестування і опис комплекту тестів), але можуть включати і результати інших видів перевірки ПС, наприклад, докази властивостей програм.
Документація другої групи містить
Керівництво по супроводу ПС (system maintenance guide), який описує відомі проблеми разом з ПС, описує, які частини системи є аппаратно- і програмно-залежними, і як розвиток ПС врахований в його будові (конструкції).
Загальна проблема супроводу ПС - забезпечити, щоб усі його представлення йшли в ногу (залишалися узгодженими), коли ПС змінюється. Щоб цьому допомогти, зв'язки і залежності між документами і їх частинами мають бути зафіксовані в базі даних управління конфігурацією.