Техническое задание: Разработка руководств
Общая задача
На основе имеющегося примера документации необходимо создать два полноценных руководства:
- Руководство пользователя
- Руководство администратора
Требования к Руководству пользователя
Документ должен содержать следующие ключевые разделы:
- Подробное описание всех режимов работы средства (программного обеспечения/системы).
- Инструкции по основным операциям и функциям, доступным пользователю.
- Наглядные примеры использования.
- Ответы на частые вопросы (FAQ) или раздел устранения типовых неполадок.
Требования к Руководству администратора
Документ должен быть ориентирован на специалиста, отвечающего за настройку, поддержку и управление системой. В нем необходимо осветить:
- Процедуры установки и первоначальной настройки.
- Управление учетными записями, правами доступа и безопасностью.
- Конфигурация системных параметров и интеграций.
- Мониторинг работы системы, сбор логов и диагностика проблем.
- Процедуры резервного копирования и восстановления.
Общие требования к оформлению
- Текст должен быть четким, структурированным и понятным для целевой аудитории.
- Необходимо использовать единый стиль изложения для обоих документов.
- Все упоминания конкретных фирм, сайтов, телефонов или иных контактных данных из исходного примера должны быть скрыты или заменены на общие формулировки (например, "название компании", "адрес сайта").
- Приветствуется использование схем, скриншотов и таблиц для наглядности (если уместно).
Цель
Создать профессиональную, готовую к использованию документацию, которая позволит пользователям эффективно работать с системой, а администраторам - грамотно ее обслуживать.