Хотя многие пользователи компьютеров часто игнорируют файлы справки, они содержат ключевую информацию о том, как использовать программное обеспечение, с которым они связаны. Нажав «Справка», пользователь может получить обзор функций программы, описание экрана, на который он или она смотрит, инструкции по использованию программы для выполнения заданной задачи или прочитать списки часто задаваемых вопросов о программа и их ответы. Написание файла справки требует как умения работать с программными приложениями, так и способности объяснять вещи понятным пользователям образом.
Шаги
Шаг 1. Получите копию программного обеспечения, которое вы хотите задокументировать
Если возможно, вам также следует получить копию письменных спецификаций программы, хотя не все разработчики программного обеспечения работают с ними. В некоторых случаях программист отклоняется от спецификаций из-за короткого времени разработки или неспособности кодировать конкретную функцию.
Шаг 2. Получите вспомогательный инструмент для разработки
Хотя можно создать файл справки вручную, используя файл в текстовом формате (.rtf), большинство авторов файлов справки используют программное приложение для написания своих файлов справки, например RoboHelp, Help and Manual, Doc-To -Помощь, MadCap Flare или HelpLogix. Большинство средств создания справки включают текстовый редактор или работу с программой обработки текста, такой как Microsoft Word, и предоставляют пользовательский интерфейс, который позволяет автору справки увидеть, как будет выглядеть файл справки, когда он или она пишет его, при написании компьютерного кода за кулисами. чтобы файл справки заработал. Некоторые инструменты разработки справки также включают графические редакторы для создания снимков экрана для включения в файл справки.
Существует несколько форматов файлов справки: Наиболее распространенным является справка HTML, которая используется приложениями, работающими в Windows. (Более старый формат WinHelp больше не поддерживается.) Apple и Unix также имеют свои собственные форматы, как и Sun Microsystems с ее JavaHelp. Программные приложения, разработанные для работы в нескольких операционных системах, могут использовать кроссплатформенную справочную систему, которая работает в веб-браузере пользователя. Какой бы инструмент создания справки вы ни использовали, он должен поддерживать формат (ы) справки, в котором вы собираетесь создавать файлы справки
Шаг 3. Создайте файл проекта справки
Ваш инструмент создания справки создаст для вас файл проекта справки на основе указанного вами имени файла и другой информации. Главный файл проекта содержит информацию о других файлах, включая файл содержимого, индексный файл, один или несколько файлов изображений и другие файлы.
- Файл содержимого включает в себя текст файла справки, который объясняет, как работает документируемое приложение. Текст обычно разбивается на темы, которые охватывают определенный экран, функцию или процедуру.
- Индексный файл - это список тем файла справки. Он используется для создания оглавления, которое пользователи могут использовать для выбора темы для просмотра, а также индекса с возможностью поиска в файле справки.
- Файлы изображений - это графические файлы экранов программы или части этих экранов, отображаемые в файле справки, чтобы пользователи могли понять, о чем идет речь в тексте файла справки.
Шаг 4. Отрегулируйте размер окна справки
Если вы не пишете файл справки для отображения в веб-браузере пользователя, файл справки будет отображаться в собственном окне. Ваш инструмент создания справки позволит вам настроить горизонтальные и вертикальные размеры окна до такого размера, который позволит конечному пользователю читать файл справки, не мешая самому приложению. Главное окно справки часто имеет трехпанельный формат, с содержанием слева и выбранной темой справа.
Файлы справки могут также иметь, помимо главного окна, дополнительные окна, в которых подробно описывается конкретная функция, и всплывающие окна с автоматическим изменением размера, дающие краткие описания функций. Файлы справки также могут включать встроенный текст, который появляется только при нажатии выделенного текста или нажатия кнопки
Шаг 5. Напишите разделы помощи
Для этого вам необходимо просмотреть спецификации или саму программу, чтобы создать темы для документирования экранов и функций программы. По мере создания каждой темы ваш инструмент создания справки будет добавлять ее в оглавление и указатель файла справки.
- Хотя вы можете составлять оглавление по ходу дела, полезно иметь некоторый план того, как его организовать. Вы можете организовать оглавление по экранам программы, ее функциям, способам использования или некоторым их сочетаниям.
- При написании тем учитывайте другую информацию в файле справки, к которой пользователи захотят иметь быстрый доступ. Вы можете создавать переходы или гиперссылки в тексте файла справки, которые связаны с темами, содержащими эту информацию.
Шаг 6. При необходимости добавьте снимки экрана
Многие функции программы лучше всего объясняются сочетанием текста и графики. Вы можете создавать снимки экрана либо с помощью приложения, которое поставляется с вашим вспомогательным средством разработки, либо с помощью отдельного приложения, такого как Microsoft Paint, Paint Shop Pro или SnagIt.
- Текст и снимки экрана должны быть размещены вместе в теме, чтобы пользователи могли видеть снимок экрана и вспомогательный текст без излишней прокрутки. Во многих случаях вам нужно показать часть экрана программы вместо всего экрана или показать снимок экрана в меньшем размере, чем оригинал. Приложение для создания снимков экрана должно иметь возможность изменять размер снимка экрана без размытия или потери деталей.
- Если вы ожидаете изменений в пользовательском интерфейсе между тестовой и финальной версиями программы, вы можете отложить создание снимков экрана до тех пор, пока у вас не будет финальной версии программы для работы.
Шаг 7. Создайте файл карты, если он нужен
Некоторые программы включают кнопки «Справка», позволяющие пользователю щелкнуть и отобразить в файле справки раздел, в котором конкретно описывается, как работает этот экран. Такой способ отображения темы называется контекстно-зависимой справкой и требует создания файла карты, чтобы программист мог связать кнопку «Справка» с определенной темой в вашем файле справки. Инструмент создания справки может создать его для вас, или программист может его закодировать и передать вам для включения в файл справки.
Шаг 8. Скомпилируйте файл справки
Компиляция создает фактический файл справки, который будет включен в программу. Для большинства форматов справки он будет включать все файлы компонентов, которые были созданы при создании файла справки, хотя некоторые некомпилированные форматы справки также требуют, чтобы отдельные файлы разделов справки были включены в программу.
Шаг 9. Протестируйте файл справки
После того, как вы скомпилируете файл справки, вам необходимо протестировать его, чтобы убедиться, что все гиперссылки связаны с темами, которые они предполагают, и вся графика отображается правильно. Файл справки также необходимо протестировать, чтобы убедиться, что содержимое является точным, подходящим для пользователей и в согласованном формате. Вы захотите просмотреть файл справки самостоятельно и попросить людей, тестирующих приложение, также просмотреть его.
В проектах с более крупными файлами справки компиляция и тестирование являются постоянными процессами. Вы захотите скомпилировать файл справки и несколько раз проверить свою работу, прежде чем создавать окончательную версию
Шаг 10. Передайте файл справки разработчику для включения в программу
В зависимости от характера проекта и формата файла справки вам, возможно, придется предоставить разработчику несколько файлов, включая файл карты, если есть контекстно-зависимые темы.
