Документування допомагає не лише користувачам, а й розробникам. У первинній нотатці я зібрав дев’ять аргументів; нижче їх уточнено без обіцянок гарантованого комерційного ефекту.
- Підготовку документації можна погодити як окремий оплачуваний обсяг робіт.
- Пояснюючи систему, автор краще осмислює її логіку.
- Записаний матеріал дає змогу відновити знання згодом.
- Відкрита документація може знайомити потенційних користувачів із продуктом, але не гарантує замовлень.
- Вимоги до інформації про продукт потрібно враховувати відповідно до застосовних норм і умов його постачання.
- Опис процесів допомагає знаходити прогалини та підвищувати якість роботи.
- Посилання на конкретну інструкцію зменшує кількість повторних пояснень.
- Добре структурований посібник полегшує навчання.
- З документації можна зрозуміти призначення й можливості рішення ще до його вибору.
Уточнення правового аргументу
У первинному тексті була категорична теза, що кожен продукт за законом обов’язково має постачатися з документацією. Без визначення виду продукту, правовідносин і конкретної норми таке узагальнення недостатнє.
Наприклад, стаття 15 Закону України № 1023-XII стосується права споживача на інформацію про продукцію й передбачає різні способи її доведення. Це не тотожне універсальній вимозі окремого однакового посібника до будь-якого програмного продукту. Офіційний текст закону.
Немає коментарів:
Дописати коментар