Справочное руководство по структуре

Всем доброго времени суток, кто решил прочитать статью, посвященную документации. Здесь вы найдёте как общие, так и довольно специфические советы по созданию руководства пользователя. Надеюсь, они будут вам полезны.

Приятного чтения.

Если перед вами стоит вопрос – нужно ли вашему продукту пользовательское руководство, то отвечу сразу – да, нужно. Почему? На это есть две причины:

1. Качественная документация повышает лояльность клиента и ценность продукта в целом.

Как это не странно, но люди до сих пор читают пользовательскую документацию. Конечно, не просто так, а когда сталкиваются с проблемой. И если с руководством все хорошо, то пользователь быстро найдет ответ на свой вопрос – это будет ещё один балл в копилку вашего проекта!

2. Руководство пользователя экономит время и силы техподдержки.

Данный факт напрямую зависит от первого. Если документация качественная, то пользователи будут редко обращаться в техподдержку, и ваша команда будет работать с действительно нестандартными ситуациями. Ну а если руководство «так себе», то поддержка будет завалена однотипными вопросами. Из-за этого пользователям придется дольше ждать ответа, поддержке больше работать, а это в свою очередь будет злить как пользователя, так и команду.

А теперь к советам!

Общие советы по созданию руководства пользователя

Прежде чем начинать писать руководство пользователя нужно ответить на несколько вопросов. — Для кого вы пишите? Кто будет пользоваться файлом справки? (ваша целевая аудитория)

— Где скорее всего пользователи будут прибегать к документации? (дома, на работе, в машине)

— Насколько объективно сложен для понимания продукт и как часто пользователь будет обращаться к документации?

И так, вы ответили на эти вопросы и теперь можете сделать вывод какого размера документация вам нужна, какой стиль изложения в ней использовать, и как часто пользователь будет читать документ.

(Для изложения лучше всего выбрать нейтрально-формальный стиль)

Структура руководства пользователя

У любого качественной документации продуманная и логичная структура. Представьте, что вы сами работаете в программе и сталкиваетесь с проблемой. Открываете файл справки – а там просто сплошной текст. Такая документация вам не поможет.

Создайте оглавление, которое будет началом вашего руководства. Оно поможет вам в дальнейшем написании документации, а также поможет пользователю ориентироваться в тексте.

В первом разделе расскажите общую информацию о продукте. Для чего создан проект и какие задачи он решает.

Во второй «главе» укажите основные элементы интерфейса. Клиент вряд ли сможет достичь своей цели в программе, если не будет знать для чего служат различные детали интерфейса. Объясните предназначение всех окон, кнопок и так далее.

Дальше расскажите, как эффективно пользоваться программой. Какие задачи стоят перед пользователем и как продукт быстро их решает.

В любом руководстве желательны разделы «Частые вопросы» и «Устранение типовых проблем». Расскажите о проблемах, с которыми часто сталкиваются клиенты и о путях их решения.

Информацию для этого раздела лучше брать у техподдержки. Проанализируйте, какие вопросы задаются чаще всего и ответьте на них один раз максимально информативно.

И последний «обязательный» раздел, которой точно должен быть в любой документации – «контактная информация». Данный раздел даст пользователю возможность связаться с разработчиком. Если руководство вдруг не закрывает потребность читателя, то он может обратиться в поддержку. Кроме того, клиент может дать совет, поделиться опытом или предложить выгодное вам сотрудничество.

Профессиональный совет: если вы хотите максимально облегчить ношу клиента при чтении документации создайте контекстно-зависимую справку. Что это такое?

Представьте, что вы работаете в программе для создания пользовательской документации. Открываете меню основных настроек и видите раздел «аннотирование экрана» Заходите в него, там показаны разные стили аннотации, тени, фон и так далее. Но что такое аннотация? Допустим вы не знаете — нажимаете кнопку F1 и перед вами открывается руководство именно на той странице, где рассказано об «аннотировании экрана»

Как ее сделать? Смотрите ниже.

Контент

И так, мы создали «каркас» нашей документации, но чтобы руководство стало полезным нужно наполнить её компетентной информацией.

Конкретного совета дать невозможно, так как все продукты разные. Поэтому расскажу про общие положения, которые делают документацию лучше.

1. Понятность.

Помните, что руководство будут читать люди, которые не сильно знакомы с вашим продуктом. Пишите простым языком, избегайте профессиональных терминов. Руководство пользователя должно быть написано на языке этого самого пользователя, а не на языке писателя.

2. Наглядность.

Добавляйте в руководство побольше графики и скриншотов с аннотациями. Читателю будет проще и приятнее решать проблему, если будет наглядно показано как это делать.

3. Видео.

Лучше один раз увидеть, чем сто раз услышать. Продемонстрируйте пользователю последовательность действий для достижения конкретной цели. Документация, содержащая видео вставки будет пользоваться большей популярностью, чем обычный текстовый документ.

Но как добавить в документацию видео? Смотрите ниже.

Больше советов!

Когда документация будет готова, чтобы она стала «полноценной» её нужно опубликовать. Иначе какой от неё толк, если клиент не может её прочитать. У «юзера» всегда должен быть доступ к документации, и не важно где он. Такую потребность легко закрывают три формата: HTML, PDF и CHM.

Создайте файл справки и загрузите его прямо в вашу программу в формате CHM. Таким образом, у пользователя будет возможность открыть документ, не выходя из программы. Не забудьте добавить элемент вызывающий руководство в меню программы.

Выложите руководство на сайт в формате HTML, чтобы клиент мог обратиться к документации, даже не работая с программой. Кроме того, документация, выложенная на сайт, повышает SEO факторы сайта.

И напоследок, переведите пользовательскую документацию в формат PDF, чтобы клиенты могли скачать и распечатать руководство.

Но помните, что после публикации документации, придется иногда её обновлять.

Инструменты

Для того, чтобы написать, а затем опубликовать документацию одного Wordа не хватит, но и пользоваться большим количеством программ тоже не хочется.

Ну и пользуясь случаем, я хочу рассказать про проект, в котором я работаю уже много лет и который закрывает все потребности писателей пользовательской документации.

Dr.Explain – программа для создания руководств пользователя для ПО, web-сервисов и баз знаний.

Благодаря «доктору» вы сможете опубликовать и обновлять документацию в востребованных форматах (CHM; HTML; PDF; DOC), не выходя из программы.

В программе есть шаблоны документации, ведь по образцу работать проще.

Импортируйте в программу заранее написанные фрагменты документации.

Вы сможете создать контекстно-зависимую документацию, настроить визуальный стиль руководства, добавить в него видео и многое другое!

Какой можно сделать вывод

Если вы хотите создать по-настоящему хорошую документацию – придется потрудиться, потому что это займет много времени и усилий всей команды. Но игра стоит свеч, так как после этого вы получите лояльных и довольных клиентов.

Руководство пользователя должно стать персональным гидом по продукту для клиента. Если пользователь останется недовольным после работы с документацией, то это может повлиять на решение отказаться от продукта.

Работая с Dr.Explain, можно быстро написать пользовательскую документацию, которая будет помогать клиентам разбираться в продукте, а вам позволит сосредоточить свои силы на более важных задачах — разработке и продвижении программного продукта.

Спасибо за внимание!

Со всеми возможностями Dr.Explain можно ознакомиться здесь:

Как написать руководство пользователя программы или сайта — инструкции, советы, помощь, программное обеспечение

Журавлев Денис

Что такое руководство пользователя и для чего его создавать

Ежедневно создаются новые продукты, программы, сервисы и часто пользователям приходится несладко при освоении какой-нибудь сложной программы, поэтому каждому новому продукту желательно собственное руководство. Для чего?

Большинство людей не хочет разбираться с чем-то незнакомым без персонального, всегда доступного и понятного помощника. А именно им и является хорошее руководство пользователя.

Общие советы по созданию пользовательской документации

Перед тем как приступить к созданию руководства, нужно определиться с некоторыми важными моментами. Например, определить, для кого вы его пишете? Кто его будет читать — рядовые пользователи, для которых важны базовые функции продукта, или люди, которым нужны особые, нечасто используемые функции программы/сервиса.

После этого важно подумать о том:

• Где пользователь будет к нему обращаться: дома, на работе, в машине?
• Как часто он будет его просматривать?
• Насколько объективно сложен для понимания продукт?

Из этого можно сделать вывод, насколько интенсивно пользователь будет работать с документацией, а значит уже можно выбрать между сжатым «справочником» или объемным «путеводителем» Также важно, чтобы руководство писал профессионал, знающий продукт. Так что по возможности делегируйте написание техническому специалисту или аналитику, у которого есть полное представление о всех тонкостях продукта.

Определившись со всеми представленными пунктами, станет понятнее, какой нужно использовать стиль изложения, какого объема написать текст. Но помните, что излишне стилистически окрашенные слова мешают пользователю добраться до сути. Так что лучшим вариантом в большинстве случаев будет нейтрально-формальный стиль. Пишите так, чтобы пользователь вас понял. Постарайтесь по возможности избегать технических терминов, но проанализируйте — не сделает ли полное отсутствие терминов ваше руководство бесполезным?

Структура руководства пользователя

После того как вы ответили на предыдущие вопросы, создайте структуру руководства. У любого хорошего «путеводителя» хорошая и логичная структура. Начните с оглавления. Информативное содержание поможет читателю легко ориентироваться в документе.

В первом разделе желательно рассказать общую информацию о программе:

• Для чего создан продукт.
• Какие задачи он решает.
• Какие основные выгоды от использования для клиента.

В следующем разделе можно указать основные элементы пользовательского интерфейса. Пользователю будет трудно разобраться в софте, если он не поймёт для чего служат различные элементы интерфейса, или он не разберётся в основных режимах работы ПО. Опишите понятным языком предназначение экранов и окон.

Создайте раздел, где расскажете о наиболее эффективных способах применения продукта для решения типовых задач. Какие цели стоят перед клиентом, и как ваша программа/сервис помогает достичь их. Укажите информацию о том, как быстро и продуктивно пользоваться программой.  

Ни одно руководство не обойдется без таких разделов как: «Частые вопросы» и «Устранение типовых проблем» В них разбираются вопросы и проблемы, с которыми часто сталкиваются пользователи. Для заполнения данного раздела вам скорее всего понадобятся уже готовые отзывы клиентов. Если у вас абсолютно новый продукт, вы можете предугадать проблемы ваших клиентов либо на первое время не включать данный пункт в ваше руководство.  

Иногда технические писатели забывают о важном моменте в руководстве пользователя — контактная информация. Этот раздел поможет пользователям связаться с вами, даже если у них нет никаких вопросов и руководство полностью закрывает все их потребности. Клиент может дать совет, поделиться опытом или предложить выгодное вам сотрудничество.

Инструменты для быстрого создания руководства пользователя

Но как создать руководство пользователя, если пишешь его впервые? Или что делать, если руководство пользователя нужно постоянно обновлять и дорабатывать? Или нужны особые функции, которых нет в традиционных текстовых редакторах, например, в MS Word.

Одним из популярных инструментов для создания качественного руководства является программа Dr. Explain (https://www.drexplain.ru), в которой уже есть готовые шаблоны руководств пользователя с готовой структурой разделов и в которой удобно обновлять документацию, как бы часто эти обновления не происходили.

Видео-обзор основных возможностей программы Dr.Explain

Удобной особенностью инструмента является возможность экспортировать один и тот же документ в форматы: HTML, CHM, PDF. Простой и понятный интерфейс сам подскажет, как быстро просмотреть документ в различных форматах и настроить его под вывод в эти форматы.

Любой проект в Dr.Explain вы можете создать с нуля или импортировать уже существующую документацию, например из формата MS Word, HTML или CHM-файла, и буквально за несколько минут создать из нее онлайн-помощь, файл справки в формате CHM, или документ в формате PDF.  

При создании руководства важно опираться на заранее составленный план. Дерево проекта в Dr.Explain поможет структурировать документ по вашему усмотрению. Вы можете добавлять, удалять перемещать разделы и переименовывать их. Для каждого раздела вы можете определить, в какой формат он будет экспортироваться. Также в работе удобно использовать статусы готовности разделов.

У программы свой собственный редактор, оптимизированный под работу со сложной документацией. Основные функции редактора вынесены в компактный тулбар. Это — управление стилем текста, форматирование абзацев, вставка ссылок, изображений, видео, таблиц и списков, а также вставка специальных объектов. Dr. Explain экономит время и силы своих пользователей. Разработчики документации часто сталкиваются с проблемой многократного использования одного и того же фрагмента текста и прибегают к очевидным решениям — «Ctrl+c», Ctrl+v». Dr.Explain предлагает решение по повторному использованию контента — текстовые переменные. Это решение экономит время, когда нужно много раз использовать один и тот же текст, особенно, который может периодически изменяться — например, версия документируемой системы.

Многие российские компании сталкиваются с тем, что руководство пользователя нужно писать согласно ГОСТ 19 и ГОСТ 34. Dr.Explain активирует поддержку требований ГОСТ фактически одним кликом. Программа автоматически сформирует структуру обязательных разделов и установит требуемые параметры страницы, стили абзацев, списков и заголовков.

Часто техническим писателям при документировании пользовательского интерфейса приходится снабжать изображения пояснительными выносками. Для таких случаев программа поддерживает специальные графические объекты — аннотированные экраны. Чаще всего аннотируются скриншоты программ и страниц веб-сайтов. Уникальной особенностью Dr.Explain является автоматическая аннотация изображений, получаемых при захвате экранов с окнами программ или сайтов. Программа анализирует структуру окон и добавляет пояснительные выноски ко всем значимым элементам.

Кроме того, Dr.Explain позволяет нескольким авторам одновременно работать над проектом с использованием сервиса www.tiwri.com, учетную запись на котором можно создать бесплатно за пару минут. При внесении правок одним автором сервис блокирует редактируемые разделы проекта для изменения другими авторами.  По окончании редактирования изменения отправляются на сервер, и блокировка снимается. Так несколько человек могут одновременно работать над различными разделами проекта без риска помешать друг другу.  

Попробовать режим многопользовательской работы в Dr.Explain можно даже с бесплатной лицензией. Вы можете создать общий проект и полноценно работать с ним в многопользовательском режиме до семи дней.

Почему компании выбирают Dr.Explain для создания руководств пользователя

Павел Свиридов, профессиональный военный, полковник, создатель астрологической системы «Вега Матрица»

«Только программа Dr.Explain обладала всеми необходимыми возможностями. А главное — она давала простор для творчества. Можно было выбрать цветовую гамму, вид и форму служебных элементов, настраиваемые шаблоны. Это позволило мне сохранить стилевое единство документации и самой программы. Ну, и конечно, полуавтоматическая обработка материала существенно облегчает и ускоряет работу по созданию хелпа.

Обучение работе в Dr.Explain было наглядным и сделано возможностями самой программы, что безусловно повлияло на мой выбор в ее пользу».

Прочитать полный кейс компании «Вега Матрица вы можете перейдя по ссылке

---

Наталья Обухова, бизнес-аналитик компании CRM Expert

«По классике жанра был пилотный проект на двух фаворитах (Dr.Explain и HelpNDoc) и муки выбора.

Через неделю справка была полностью готова. Конечно, если мы набивали ее «с нуля», за это время мы бы не успели. Мы просто конвертировали все бумажные инструкции во внутренний формат программ, изменили каталогизацию и организовали систему гиперссылок.

Сначала фаворитом выбора была другая система, но решающим фактором в пользу Dr.Explain стал возглас человека, выполняющего основную часть работы по переносу текста: «Вжух! И вся структура документа перенеслась в файл справки». Функция импорта в Dr.Explain отработала на ура и сэкономила кучу времени.

Также очень подкупил дизайн веб-справки, который формируется Dr.Explain, и красивый способ организации подписей к окнам нашей системы. В Dr.Explain это называется «Аннотирование экрана».

Возможность установки статуса раздела тоже оказалась очень удобной, особенно, после импорта старой версии справки легко отслеживать, какие разделы требуют обновления, в каких еще ведутся изменения, а какие уже обновлены и актуальны».

Прочитать полный кейс компании CRM Expert

---

Николай Вальковец, разработчик компании 2V

«Мы значительно сократили время работы техподдержки с новыми клиентами на этапе подключения. Раньше требовалось проводить онлайн презентации и видео конференции для новых клиентов, объясняя особенности программы. Сейчас же, один раз постаравшись максимально подробно всё описать, мы избавили себя и нашу техподдержку от этой работы. Нам импонирует простота программы и скорость работы. Можно быстро редактировать, добавить новые пункты в документацию, сохранить в формате HTML и выложить на сайт».

Прочитать кейс компании V2  

---

Подытожим

Создание и написание хорошей пользовательской документации — это труд, который требует много времени и усилий. Но если успешно справиться с задачей, можно навсегда получить лояльных и довольных клиентов. Не забывайте о том, что недовольство от некачественного руководства может быть спроецировано пользователем на сам продукт и повлиять на дальнейшие решения о его выборе. Пользовательская документация должна стать персональным и незаменимым помощником. Используя Dr. Explain, вы сможете быстро создать качественное руководство пользователя, которое будет помогать пользователям разбираться в продукте, а вам позволит сосредоточить свои силы на более важных задачах — разработке и продвижении программного продукта.

Скачать Dr.Explain с неограниченной по срокам возможностью бесплатной работы можно по адресу: https://www.drexplain.ru/download/

Успешных вам разработок!

Смотрите также

• Dr.Explain — инструмент для создания мобильной версии пользовательской документации к программным продуктам
• Шаблоны файлов помощи, руководства пользователя программного обеспечения или сайта, шаблон базы знаний — бесплатные шаблоны и примеры пользовательской документации

Сравнительный анализ структур руководств пользователя программы по ЕСПД и IEEE Std 1063-2001 с учетом рекомендаций «манифеста Кагарлицкого». Показано, что обобщенная структура руководства пользователя, собранная согласно требованиям «устаревших» ГОСТов 19-й системы, существенно превосходит структуру руководства, рекомендуемую суперсовременным IEEE Std 1063-2001. Редакция от 23.01.2022.

Создан 11.02.2005 11:14:22

Когда умирает надежда, приходит отчаяние.

Мудрая латинская поговорка

Как писать руководство пользователя программы? Создать древовидную иерархическую структуру разделов руководства пользователя и заполнить ее разделы содержимым. И вся любовь.

Где взять структуру разделов руководства пользователя? С руководствами на изделия (руководство по эксплуатации по ГОСТ 2.601-95) и на автоматизированные системы (руководство пользователя по РД 50-34.698-90) все более или менее ясно. А вот сам документ «Руководство пользователя» программы в ГОСТах 19-й системы отсутствует как класс.

Каким содержимым наполнять разделы руководства пользователя? Как быть? Главное — не отчаиваться.

Цели и задачи статьи

Цель, как всегда, — попытаться облегчить жизнь разработчику руководства пользователя программы.

Задачи:

• проанализировать существующие стандарты и рекомендации по разработке эксплуатационной программной документации, выявить достоинства и недостатки каждого документа по отдельности;
• вывести некую обобщенную структуру руководства пользователя по ГОСТам 19-й системы из имеющегося набора эксплуатационных программных документов;
• сравнить ее со структурой, рекомендованной IEEE Std 1063-2001;
• а все прочие задачи перекочевали во 2-ю часть статьи…

Примечание от 10.07.2014 г. — В феврале 2005 года был проведен, пожалуй, даже не сравнительный анализ, а скорее сравнительные испытания, показавшие неоспоримое превосходство ГОСТов 19-й системы стандартов над буржуйскими и практически полную несостоятельность последних.

Вопросы, на которые должно дать ответы руководство пользователя

Подарите ребенку незнакомую ему электронную игрушку. Перечень вопросов будет примерно таким (если сразу же не разломает):

• а что это;
• а что им можно делать;
• а что им нельзя делать (у особо одаренных);
• а что надо, чтобы оно работало;
• а что там у него внутри (у детей, склонных к глубокому анализу);
• а как его настроить, чтобы работало так, как я хочу;
• а как его проверить, работает оно или не работает;
• а что и где надо нажимать;
• а что оно еще может делать;
• а что оно говорит, если что-то не так нажимаешь?

Последовательность вопросов может оказаться самой разнообразной. И документ под названием «Руководство пользователя» должен дать ответы на все поставленные вопросы. Все просто. Не так страшен черт, как его малюют.

Руководство пользователя: четыре источника и четыре составных части

Располагаем документами:

• «метагайдом» Кагарлицкого;
• суперсовременным IEEE Std 1063-2001, «IEEE Standard for Software User Documentation»;
• классическими отечественными ГОСТами 19-й системы, включающим в себя перечисленные ниже документы «описательного» характера:
  • ГОСТ 19.402-78 ЕСПД. Описание программы;
  • ГОСТ 19.502-78 ЕСПД. Описание применения. Требования к содержанию и оформлению;
  • ГОСТ 19.503-79 ЕСПД. Руководство системного программиста. Требования к содержанию и оформлению;
  • ГОСТ 19.504-79 ЕСПД. Руководство программиста. Требования к содержанию и оформлению;
  • ГОСТ 19.505-79 ЕСПД. Руководство оператора. Требования к содержанию и оформлению.

Крайняя четверка из перечня — эксплуатационные программные документы.

Возможно, существуют и иные документы, но автору, основательно порывшемуся в рунетовской свалке, ничего более подходящего заполучить пока не удалось. Яндекс обнаружил в своих недрах еще одну страничку с названием «Как сделать хорошее руководство пользователя», автор которой именует себя на американЬский манер (типа John P. Morgan). Двухстраничное «наставление» с радостными возгласами было немедленно отправлено в корзину.

Манифест Кагарлицкого

Метагайд Кагарлицкого показался многообещающим. Только автор настоящей статьи не уразумел, что есть «метагайд», поэтому позволил себе наглось обозвать метагайд «манифестом». И не погрешил против истины (но это открылось позже — ниже).

(цитаты из манифеста Кагарлицкого)

Мы стремились свести в единую систему всю совокупность типовых требований, которые должны, с нашей точки зрения, предъявляться к технической документации: руководствам, справочникам и т.д. При этом мы основывались на стандартах(!!!) ГОСТ, стандартах компании Microsoft, опыте наших сотрудников и других разработчиков технической документации.

Начало обнадеживающее.

В состав технической документации входят две стержневые части, которые мы будем называть соответственно руководством пользователя и справочником пользователя, или коротко: руководством и справочником (по аналогии с английскими словосочетаниями User’s Guide и User’s Reference). Они могут быть оформлены в виде отдельных документов (для крупных программных продуктов), а могут, напротив, существовать в интегрированном виде. Между ними даже может не быть четкой границы: единый текст способен совмещать в себе черты руководства и черты справочника.

Что-то не так. Автору статьи всегда «казалось», что термин техническая документация трактуется более широко, значительно шире, чем эксплуатационная (программная) документация.

Руководство и справочник — это не столько части документации, сколько понятия, которые воплощают собой два подхода к описанию программного продукта.

По-понятиям так по-понятиям, вот только пацаны начинают нервничать. Руководство не есть понятие, а есть вид документа.

Наша задача не столько в том, чтобы рассказать, как выглядит документация, сколько в том, чтобы дать конкретные рекомендации по ее разработке. Всем известно, какие проблемы возникают в процессе написания связного текста большого объема — как приступить к работе, с чего начать, как расположить материал. Этот подход побуждает видеть в провозглашаемых нами нормах не хаотический их перечень, а иерархическую систему…

На небосклоне засияла звезда по имени Надежда — сейчас уважаемый г-н Кагарлицкий выдаст нам, лишенцам, всеобъемлющую иерархическую структуру руководства пользователя всех времен и народов. Ну же?!

Прежде чем приступить к разработке документации как таковой, необходимо наметить и спланировать общую логику изложения. Может показаться, что жанр технической документации крайне прост: ведь его задачей является «всего лишь» сообщение пользователю некоторых сведений о продукте. Однако если Вы будете исходить из этого в своей работе, Вы будете создавать образцы документации, вовсе непригодные или едва пригодные для практического использования, — даже если все необходимые сведения будут там содержаться. Ваша задача состоит в том, чтобы провести пользователя через перевал, то есть найти в горной цепи место, которое хотя бы и с трудом, но все-таки проходимо для Вашего «подопечного».

Жаль… А так все хорошо начиналось. Со «стандартов ГОСТ» — «стандартов ГОсударственных СТандартов» — простим г-на Кагарлицкого за тавтологию. Только вот решения первой задачи, поставленной автором настоящей статьи, в семидесятидвухстраничном манифесте (Arial’ом 12pt) нет. Уважаемый автор манифеста лишь поставил нам задачу. Что ж, нет пророка в своем отечестве. Может, есть пророк в отечестве буржуйском?

Руководство пользователя по IEEE Std 1063-2001 «IEEE Standard for Software User Documentation»

Забугорный «пророческий» документ IEEE Std 1063-2001 (IEEE в простонародье — «ай-яй-яй») в подразделе 1.2 (Puprose) содержит такую строчку:

This revision provides requirements for the structure, information content, and format of both printed and electronic documentation.

В авторском понимании назначение (намерение, цель, замысел, стремление) документа IEEE Std 1063-2001 состоит в «обеспечении требований к структуре, информационному наполнению, форматированию (оформлению) как электронной, так и печатной пользовательской документации по программным средствам». Что ж, подходяще. Какую же структуру руководства пользователя предлагает IEEE Std 1063-2001?

Структура руководства пользователя по IEEE Std 1063-2001

Опциональная типовая структура руководства пользователя содержится в таблице из раздела Structure of software user documentation документа IEEE Std 1063-2001:

Component	See subclause	Required?
Identification data (package label/title page)	4.3	Yes
Table of contents	5.7.1	Yes, in documents of more than eight pages after identification data
List of illustrations	5.7.2	Optional
Introduction	3.2	Yes
Information for use of the documentation	4.4	Yes
Concept of operations	4.5	Yes
Procedures	4.6, 4.7	Yes (instructional mode)
Information on software commands	4.8	Yes (reference mode)
Error messages and problem resolution	4.9	Yes
Glossary	4.10	Yes, if documentation contains unfamiliar terms
Related information sources	4.11	Optional
Navigational features	5.8	Yes
Index	5.7.3	Yes, if documents of more than 40 pages
Search capability	5.7.4	Yes, in electronic documents

For purposes of this standard, the following non-mandatory nomenclature is used for the structural parts of software user documentation. A printed document is structured into logical units called chapters, subdivided into topics, which may be subdivided into subtopics, and printed on physical units called pages.

Здорово. IEEE Std 1063-2001 предлагает «все взять и поделить» — разбить разделы руководства на главы, топики, субтопики и т.д. И наступит всем счастье.

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

Introduction

Какие сведения должны быть изложены в разделе Introduction согласно IEEE Std 1063-2001? А вот какие

The introduction shall describe the intended audience, scope, and purpose for the document and include a brief overview of the software purpose, functions, and operating environment.

Что ж, замечательно. Структура подразделов Introduction начинает как-то вырисовываться.

Information for use of the documentation

The documentation shall include information on how it is to be used (for example, help on help), and an explanation of the notation (a description of formats and conventions-see 5.8). At least one document in a document set shall identify all documents in the set by title and intended use, including recommendations on which members of the audience should consult which sections of the documentation. In document sets comprising many volumes or products, this information may be provided in a separate «road map» or guide to the document set. Documentation may include identification and discussion of notable changes from the previous version of the document set and the software.

Весьма полезный раздел (в контексте разработки руководства пользователя). Руководство по руководству.

Concept of operations

Documentation shall explain the conceptual background for use of the software, using such methods as a visual or verbal overview of the process or workflow; or the theory, rationale, algorithms, or general concept of operation. Explanations of the concept of operation should be adapted to the expected familiarity of the users with any specialized terminology for user tasks and software functions. Documentation shall relate each documented function to the overall process or tasks. Conceptual information may be presented in one section or immediately preceding each applicable procedure.

Концептуальная информация безусловно важна.

Procedures

Task-oriented instructional mode documentation shall include instructions for routine activities that are applied to several functions:

— Software installation and de-installation, if performed by the user

— Orientation to use of the features of the graphical user interface (see 5.6)

— Access, or log-on and sign-off the software

— Navigation through the software to access and to exit from functions

— Data operations (enter, save, read, print, update, and delete)

— Methods of canceling, interrupting, and restarting operations

These common procedures should be presented once to avoid redundancy when they are used in more complex functions.

И пошла конктерика. Молодцы, буржуи!

Information on software commands

Documentation shall explain the formats and procedures for user-entered software commands, including required parameters, optional parameters, default options, order of commands, and syntax. Documentation may be provided on the development and maintenance of macros and scripts. Reference mode documentation shall contain a reference listing of all reserved words or commands. Examples should illustrate the use of commands. Documentation shall explain how to interrupt and undo operation during execution of a command and how to restart it, if possible. Documentation shall describe how to recognize that the command has successfully executed or abnormally terminated.

Error messages and problem resolution

Documentation should address all known problems in using the software in sufficient detail such that the users can either recover from the problems themselves or clearly report the problem to technical support personnel. Reference mode documentation shall include each error message with an identification of the problem, probable cause, and corrective actions that the user should take. A quick reference card may address error messages by referring the user to more detailed reference documentation. The documentation on resolving problems shall also include contact information for reporting problems with software or its documentation and suggesting improvements.

Выводы по IEEE Std 1063-2001

Но счастье оказалось неполным… Структура разделов первого уровня руководства показана в таблице явно. А дальше — «милый мой, хороший, догадайся сам» («догадайся, мол, сама»). IEEE Std 1063-2001, конечно, «provides requirements for the structure», но не предлагает явной структуры руководства пользователя до рекомендованного ГОСТ 2.105 четвертого уровня вложенности.

Рекомендации типа «Documentation shall explain…», «Examples should illustrate…», «Documentation shall describe…» и им подобные, безусловно, проверены временем. В руководстве пользователя надо и объяснять, и иллюстрировать, и описывать — без всякого сомнения. Но все это и козе понятно, и в ГОСТах 19-й системы прописано.

Итак, вряд ли целесообразно разрабатывать руководства пользователя, основываясь исключительно на рекомендациях IEEE Std 1063-2001. Причины, как минимум, две:

• отсутствие в IEEE Std 1063-2001 четко регламентированной структуры руководства пользователя;
• «поверхностность» IEEE Std 1063-2001, отсутствие «широты охвата» и «глубины проработки».

Отсутствие четко регламентированной структуры руководства пользователя даст возможность заказчику ТРЕТИРОВАТЬ разработчика, см. хотя бы Страшная правда о техническом задании. Бедняга-разработчик будет вынужден, по указке заказчика, изо дня в день менять местами разделы руководства пользователя (гарантированный минимум, полученный опытным путем).

Отсутствие четко регламентированной структуры оборачивается хаосом, как только уровень вложения заголовков снижается до второго-третьего. Пользователь просто зашвырнет такое руководство куда подальше и назовет его автора кретином.

По мнению автора, рекомендации IEEE Std 1063-2001, разработанного при участии сотни забугорных спецов, весьма и весьма поверхностны. Не сможет разработчик, работая по IEEE Std 1063-2001, охватить максимум «характеристик», свойственных программе. В IEEE Std 1063-2001 многие из них попросту не прописаны. Отсутствуют «широта охвата» и «глубина проработки», свойственные отечественным документам.

В крайнем разделе настоящей статьи приведена таблица соответствия ГОСТ 19 и IEEE Std 1063-2001, которую автор статьи начал было составлять, затем бросил и проверять не стал. А выводы пусть каждый сделает сам для себя. И, возможно, в чем-то поправит автора.

Пользовательские документы по ГОСТ 19 (ЕСПД)

В отличие от суперсовременного буржуйского IEEE Std 1063-2001, древние, многими ругаемые отечественные стандарты 19-й системы (Единая система программной документации — ЕСПД) содержат не пространные рассуждения о том, что и как должно разъяснять, иллюстрировать и описывать руководство пользователя, а конкретные требования к структуре и содержанию пользовательских (эксплуатационных) документов.

Перечень ГОСТов 19 «описательного» характера, на основе которых можно, не мудрствуя лукаво, сформировать четкую структуру разделов каждого из «описательных» документов, приведен в разделе Источники. Основной прием — детализация — подробно описан в статье «Как писать техническое задание?!». Далее — сформированные «детализацией» структуры разделов документов согласно ГОСТам из перечня.

Структура разделов описания программы по ГОСТ 19.402-78

Структура разделов описания применения по ГОСТ 19.502-78

Структура разделов руководства системного программиста по ГОСТ 19.503-79

Структура разделов руководства программиста по ГОСТ 19.504-79

Структура разделов руководства оператора по ГОСТ 19.505-79

Выводы по ГОСТам 19.ххх

Ни ГОСТ 19.505-79, ни ГОСТ 19.504-79, ни ГОСТ 19.503-79, взятые по одельности, не могут похвастаться достаточной полнотой структуры.

Зато структуры «описательных» документов ГОСТ 19 обладают как полностью идентичными (по тексту названий), так и схожими по тексту названий разделами и подразделами. К идентичным разделам относятся, к примеру, разделы «Аннотация», имеющие место во всех документах согласно ГОСТ 19.105-78. К схожим (фактически — идентичным) можно отнести подразделы «Назначение программы» и «Сведения о назначении программы».

А почему не попытаться объединить все «описательные» документы? Объединить идентичные и схожие разделы документов, выделить специфические разделы? Быть может, удастся избавиться от неполноты ГОСТ 19.505-79, ГОСТ 19.504-79 и ГОСТ 19.503-79 и получить обобщенную структуру «описательного» документа и обозвать сам документ руководством пользователя программы?

ГОСТы 19.ххх допускают «вводить дополнительные разделы или объединять отдельные разделы», а также «вводить новые». Согласно ГОСТ 19.101-77 «Допускается объединять отдельные виды эксплуатационных документов (за исключением ведомости эксплуатационных документов и формуляра). Необходимость объединения этих документов указывается в техническом задании. Объединенному документу присваивают наименование и обозначение одного из объединяемых документов. В объединенных документах должны быть приведены сведения, которые необходимо включать в каждый объединяемый документ [из 2.6 ГОСТ 19.101-77]»

Сказано — сделано. Только мы нарушим ГОСТы и создадим объединенный документ под названием «Руководство пользователя».

Обобщенная структура руководства пользователя по ГОСТам 19-й системы

Путем слияния структур «описательных» документов ГОСТов 19-й системы в единую структуру, удаления «лишних» одноименных разделов, слияния схожих разделов сформирована общая структура руководства пользователя программы. В табличке сведены и «*» отмечены разделы, присутствующие в каждом отдельном документе.

ГОСТ 19.ххх — обобщенная структура разделов руководства	ГОСТ 19.402-78	ГОСТ 19.502-78	ГОСТ 19.503-79	ГОСТ 19.504-79	ГОСТ 19.505-79
Аннотация	*	*	*	*	*
•Назначение документа	*	*	*	*	*
•Краткое изложение основной части документа	*	*	*	*	*
Общие сведения о программе	*		*
•Обозначение и наименование программы	*			*
•Языки программирования, на которых написана программа	*
•Сведения о назначении программы	*	*	*	*	*
••Информация, достаточная для понимания функций программы и ее эксплуатации					*
•••Возможности программы		*
•••Классы решаемых задач	*
••••Описание задач		*
••••Методы решения задач		*
•••Функции, выполняемые программой			*	*
••Описание основных характеристик и особенностей программы		*		*
•••Временные характеристики				*
•••Режим работы				*
•••Средства контроля правильности выполнения и самовосстанавливаемости программы				*
••Ограничения области применения программы		*
•••Сведения о функциональных ограничениях на применение	*
Условия применения программы		*		*	*
•Условия, необходимые для выполнения программы		*	*		*
••Сведения о технических и программных средствах, обеспечивающих выполнение программы			*
•••Требования к техническим средствам	*	*
••••Типы ЭВМ, устройства, используемые при работе программы	*
••••Объем оперативной памяти				*
••••Минимальный и (или) максимальный состав аппаратурных и программных средств					*
••••Требования к составу и параметрам периферийных устройств				*
•••Программное обеспечение, необходимое для функционирование программы	*
••••Требования к программному обеспечению				*
••••Требования к другим программам		*
••••Требования и условия организационного, технического и технологического характера		*
Описание логической структуры	*
•Алгоритм программы	*
•Используемые методы	*
•Сведения о структуре программы	*		*
•Сведения о составных частях программы			*
•Описание функций составных частей	*
•Сведения о связях между составными частями программы	*		*
•Сведения о связях с другими программами	*		*
Сведения о входных и выходных данных		*		*
•Общие характеристики входной и выходной информации		*
•Сведения о входных данных	*	*
••Характер, организация и предварительная подготовка входных данных	*			*
•Сведения о выходных данных	*	*
••Характер и организация выходных данных	*			*
••Формат, описание и способ кодирования выходных данных	*
•Описание кодирования информации				*
Настройка программы			*
•Описание действий по настройке программы			*
••Настройка на состав технических средств			*
••Выбор функций			*
••Поясняющие примеры			*
Проверка программы			*
•Описание способов проверки работоспособности программы			*
••Контрольные примеры			*
••Методы прогона			*
••Результаты			*
Выполнение программы					*
•Загрузка программы •Способ вызова программы с соответствующего носителя данных •Описание процедур вызова программы	*			*	*
•Запуск программы					*
•Входные точки в программу*	*
•Способы передачи управления и параметров данных				*
•Выполнение программы					*
••Описание выполняемой функции 1					*
••Формат и возможные варианты команд для выполнения функции 1					*
••Ответы программы на команды выполнения функции 1					*
•Завершение выполнения программы					*
Дополнительные возможности			*
•Описание дополнительных функциональных возможностей программы			*
•Описание применения дополнительных функциональных возможностей программы			*
Сообщения программы			*	*	*
•Тексты сообщений, выдаваемых в ходе (настройки, проверки, выполнения) программы			*	*	*
••Описание содержания			*	*	*
••Описание действий, которые необходимо предпринять по этим сообщениям			*	*	*

Выводы по обобщенной структуре руководства пользователя по ГОСТ 19.ххх

Обобщенная структура руководства пользователя по ГОСТ 19.ххх явно не страдает, как IEEE Std 1063-2001, отсутствием широты охвата. Избыток, как известно, рождает качество. Перечислено все, чем может характеризоваться программа. Отдельные подразделы могут показаться даже излишними, к примеру, подраздел «Языки программирования, на которых написана программа».

Казалось бы, какое дело пользователю, на каком языке был написан исходный текст программы? С другой стороны, может «…это кому-нибудь нужно? Значит — это необходимо…». Ведь хочется при покупке буржуйского телевизора заполучить и принципиальную схему на него. Самсунги и соньки тоже выходят из строя. А вдруг неисправность пустяковая и устранить ее представляется возможным в домашних условиях, без поездки в сервисный центр?

В то же время, при всей широте охвата, в явном виде отсутствуют:

• Software installation and de-installation, if performed by the user;
• Orientation to use of the features of the graphical user interface;
• Access, or log-on and sign-off the software;
• Navigation through the software to access and to exit from functions и многое другое.

Автору удалось разбросать кое-что в разделе Таблица соответствия ГОСТ 19.ххх и IEEE Std 1063-2001, но времени «наморщить ум» всегда не хватает, руководство пользователя, как всегда, должно было быть готово еще на прошлой неделе.

Показать связи разделов обобщенного руководства пользователя с разделами ГОСТ 19.201-78 ЕСПД. Техническое задание, требования к содержанию и оформлению автор поленился, поскольку указанные связи очевидны.

Выводы по источникам

Итак, если первые три задачи в целом решены, крайняя задача осталась нерешенной.

Автор манифеста более склонен к рекомендациям по подбору слов* и построению предложений, IEEE Std 1063-2001, в лучшем случае, приводит требования к структуре руководства пользователя, но не дает особой конкретики, в ГОСТ 19.ххх не прописаны процедуры заполнения содержимым разделов руководства. Может, организовать эдакую смесь французского с нижегородским? Использовать все четыре источника в качестве четырех составных частей?

* Нынче в моде буржуйское понятие — т.н. контролируемый язык. Среди представителей «просвещенной русской интеллигенции» наибольшей популярностью пользуется отечественный аналог в глагольной форме повелительного наклонения — фильтруй базар!

Смесь французского с нижегородским

Почему бы нет? Взять лучшее из ГОСТов 19-й системы, — обобщенную структуру руководства пользователя, добавить к ней немногочисленные толковые рекомендации из IEEE Std 1063-2001 и разбавить неисчерпаемой стилистической культурой и ресурсами языка из манифеста Кагарлицкого? Придать смеси стройный строгий вид, сформировать очередной учебно-тренировочный документ с подробными комментариями? А что делать, если ни один из перечисленных выше источников и составных частей в отдельности не способны дать ответы на все поставленные вопросы?

Таблица соответствия ГОСТ 19 и IEEE Std 1063-2001

ГОСТ 19.ххх	IEEE Std 1063-2001
Аннотация	Introduction
	The introduction shall describe the intended audience, scope, and purpose for the document and include a brief overview of the software purpose, functions, and operating environment
•Назначение документа	purpose for the document (Introduction)
•Краткое изложение основной части документа	scope (Introduction)
Общие сведения о программе
•Обозначение и наименование программы	аналогичный подраздел отсутствует
•Языки программирования, на которых написана программа	то же
•Сведения о назначении программы	brief overview of the software purpose (Introduction)
••Информация, достаточная для понимания функций программы и ее эксплуатации	аналогичный подраздел отсутствует
•••Возможности программы	то же
•••Классы решаемых задач	»
••••Описание задач	»
••••Методы решения задач	Documentation shall relate each documented function to the overall process or tasks
•••Функции, выполняемые программой	brief overview of the software … functions (Introduction)
••Описание основных характеристик и особенностей программы	аналогичный подраздел отсутствует
•••Временные характеристики	то же
•••Режим работы	»
•••Средства контроля правильности выполнения и самовосстанавливаемости программы	»
••Ограничения области применения программы	»
•••Сведения о функциональных ограничениях на применение	»
Условия применения программы	If different versions of the software are available for different operating environments, the title page should specify the applicable operating environment(s), including version(s) of hardware, communications, and operating system(s) (4.3. Content of identification data)
•Условия, необходимые для выполнения программы	аналогичный подраздел отсутствует
••Сведения о технических и программных средствах, обеспечивающих выполнение программы	Documentation for the hardware and software environment (4.11 Information on related information sources)
•••Требования к техническим средствам	аналогичный подраздел отсутствует
••••Типы ЭВМ, устройств, используемые при работе программы	то же
••••Объем оперативной памяти	»
••••Минимальный и (или) максимальный состав аппаратурных и программных средств	»
••••Требования к составу и параметрам периферийных устройств	»
•••Программное обеспечение, необходимое для функционирование программы	brief overview of the … operating environment (Introduction)
••••Требования к программному обеспечению	аналогичный подраздел отсутствует
••••Требования к другим программам	то же
•••Требования и условия организационного, технического и технологического характера	»
Описание логической структуры
•Алгоритм программы	algorithms (4.5 Concept of operations)
•Используемые методы	using such methods as a visual or verbal overview of the process or workflow (4.5 Concept of operations)
•Сведения о структуре программы	аналогичный подраздел отсутствует
•Сведения о составных частях программы	то же
•Описание функций составных частей	»
•Сведения о связях между составными частями программы	»
•Сведения о связях с другими программами	»
Сведения о входных и выходных данных
•Общие характеристики входной и выходной информации	аналогичный подраздел отсутствует
•Сведения о входных данных	то же
••Характер, организация и предварительная подготовка входных данных	»
•Сведения о выходных данных	»
••Характер и организация выходных данных	»
••Формат, описание и способ кодирования выходных данных	»
•Описание кодирования информации	»
Настройка программы	Identification of technical or administrative activities that must be done before starting the task (4.7 Information for procedures and tutorials)
•Описание действий по настройке программы	аналогичный подраздел отсутствует
••Настройка на состав технических средств	то же
••Выбор функций	»
••Поясняющие примеры	»
Проверка программы
•Описание способов проверки работоспособности программы	аналогичный подраздел отсутствует
••Контрольные примеры	Examples should illustrate the use of commands (4.8 Information on software commands)
••Методы прогона	аналогичный подраздел отсутствует
••Результаты	то же
Выполнение программы
•Загрузка программы •Способ вызова программы с соответствующего носителя данных •Описание процедур вызова программы	Software installation and de-installation, if performed by the user (4.6 Information for general use of the software)
•Запуск программы	аналогичный подраздел отсутствует
•Входные точки в программу*	Access, or log-on and sign-off the software (4.6 Information for general use of the software)
•Способы передачи управления и параметров данных	аналогичный подраздел отсутствует
•Выполнение программы	то же
••Описание выполняемой функции 1	A brief overview of the purpose of the procedure and definitions or explanations of necessary concepts not elsewhere included (4.7 Information for procedures and tutorials)
••Формат и возможные варианты команд для выполнения функции 1	Navigation through the software to access … functions (4.6 Information for general use of the software) Instructional steps shall be presented in the order of performance (4.7 Information for procedures and tutorials) Documentation shall explain how to interrupt and undo operation during execution of a command and how to restart it, if possible. Documentation shall explain the formats and procedures for user-entered software commands, including required parameters, optional parameters, default options, order of commands, and syntax (4.8 Information on software commands)
••Ответы программы на команды выполнения функции 1	Documentation shall describe how to recognize that the command has successfully executed or abnormally terminated (4.8 Information on software commands)
•Завершение выполнения программы	Navigation through the software … to exit from functions Methods of canceling, interrupting, and restarting operations (4.6 Information for general use of the software)
Дополнительные возможности
•Описание дополнительных функциональных возможностей программы	аналогичный подраздел отсутствует
•Описание применения дополнительных функциональных возможностей программы	то же
Сообщения программы	Relevant warnings, cautions, and notes that apply to the entire procedure (4.7 Information for procedures and tutorials)
•Тексты сообщений, выдаваемых в ходе (настройки, проверки, выполнения) программы	аналогичный подраздел отсутствует
••Описание содержания	то же
••Описание действий, которые необходимо предпринять по этим сообщениям	»

Previous

Next

---

---

---

---

---

---

---

---

---

---

---

---

---

---

---

---

---

Скачать Руководство по структуре и организации службы эксплуатации искусственных сооружений на автомобильных дорогах

Дата актуализации: 17.06.2011

Руководство по структуре и организации службы эксплуатации искусственных сооружений на автомобильных дорогах

Статус:	действует
Название рус.:	Руководство по структуре и организации службы эксплуатации искусственных сооружений на автомобильных дорогах
Дата актуализации текста:	01.10.2008
Дата добавления в базу:	01.02.2009
Дата введения:	25.11.1993
Разработан в:	НПО Росдорнии Российской Федерации 125493, Москва, ул. Смольная, 1/3, влад. 2 МАДИ 125319, Москва, Ленинградский проспект, 64
Утверждён в:	Федеральный дорожный департамент Минтранса РФ (25.11.1993)
Опубликован в:	№ 1994
Область и условия применения:	В руководстве изложены задачи и обязанности службы эксплуатации искусственных сооружений, структура и функции, возлагаемые на ее подразделения, расчет нормативной численности работников, состав работ по ремонту и содержанию, оснащенность подразделений, а также примеры пользования указанными расчетами.
Оглавление:	Введение 1 Задачи службы эксплуатации искусственных сооружений 2 Структура и организация службы эксплуатации 2.1 Общие положения 2.2 Функции мостовой группы (отдела или подотдела мостов) 2.3 Функции производственных подразделений 2.4 Рекомендуемые варианты формирования подразделений 3 Структура управления производственного подразделения (МЭУ) 3.1 Состав и функции аппарата МЭУ 3.2 Состав и функции группы механизации 3.3 Состав и функции производственных подразделений (МЭУ) 3.4 Специфика работы производственных подразделений по эксплуатации искусственных сооружений 3.5 Расчет нормативной численности рабочих 4 Примерный перечень работ по содержанию и ремонту мостов и путепроводов (эстакад) 4.1 Содержание. Работы по уходу за сооружением 4.2 Содержание. Профилактические работы 4.3 Ремонт (ППР) 4.4 Ремонт 5 Оснащенность подразделений службы эксплуатации Приложение 1 Возможные схемы эксплуатаци моста Приложение 2 Перечень нормативных и методических документов составляющих нормативно-техническую базу службы эксплуатации искусственных сооружений
Расположен в:	Строительная документация Отраслевые и ведомственные нормативно-методические документы Проектирование и строительство искусственных сооружений на автомобильных и железных дорогах Автомобильные дороги Проектирование, строительство, ремонт и содержание автомобильных дорог Ремонт, содержание, эксплуатация автомобильных дорог Проектирование, строительство, ремонт и содержание искусственных сооружений на автомобильных дорогах Реконструкция, ремонт и содержание искусственных сооружений Общие документы

Скачать

---

Структуры данных  —  это способ систематической организации данных для эффективного их использования. Различные типы структур данных так или иначе используются почти в каждом корпоративном приложении. Пройдя это руководство, вы получите четкое представление о структурах данных, необходимое для понимания сложности приложений корпоративного уровня.

Базовыми для структуры данных являются следующие термины:

• Интерфейс  —  это набор поддерживаемых структурой данных операций. Он есть у каждой структуры данных. Интерфейс предоставляет только список поддерживаемых операций, тип принимаемых ими параметров, а также возвращаемый тип этих операций.
• Реализация  —  она обеспечивает внутреннее представление структуры данных, а также определение алгоритмов, используемых в операциях структуры данных.

---

Зачем изучать структуры данных и алгоритмы?

С ростом объема данных и сложности современных приложений связаны три основные проблемы:

• Поиск данных. Допустим, нам надо провести инвентаризацию 1 миллиона (1⁰⁶) элементов в хранилище. Если доверить ее приложению, с каждым разом поиск элемента среди такого их количества будет все медленнее, ведь объем данных растет.
• Скорость процессора, хотя и очень высокая, с ростом данных до миллиарда записей оказывается ограниченной.
• Множественные запросы. Если тысячи пользователей будут одновременно искать данные, даже быстрый веб-сервер выйдет из строя.

Решить эти проблемы помогают структуры данных, которые организованы так, что поиск по всем элементам не требуется, а нужные данные находятся почти мгновенно.

С помощью структур данных программно решаются следующие задачи:

• последовательность чисел Фибоначчи;
• задача о ранце;
• ханойская башня;
• поиск кратчайшего пути между всеми парами вершин (алгоритм Флойда-Уоршелла);
• поиск кратчайших путей от одной из вершин графа до всех остальных (алгоритм Дейкстры);
• планирование проектов.

---

Характеристики структуры данных

• Корректность. Интерфейс структуры данных должен реализовываться корректно.
• Временная сложность. Время выполнения операций структуры данных должно быть как можно меньшим.
• Пространственная сложность. Использование памяти при выполнении операции структуры данных должно быть как можно меньшим.

---

Случаи времени выполнения

Для сравнения времени выполнения различных структур данных обычно используется три случая:

• Наихудший случай —  это сценарий, при котором конкретная операция структуры данных занимает максимально возможное время. Если время операции в наихудшем случае равно ƒ(n), то эта операция займет не более ƒ(n) времени, где ƒ(n) — это функция от n.
• Средний случай  —  это сценарий, описывающий среднее время выполнения операции структуры данных. Если на выполнение операции уходит ƒ(n) времени, то на m операций уйдет mƒ(n) времени.
• Наилучший случай  —  это сценарий, описывающий минимально возможное время выполнения операции структуры данных. Если на выполнение операции требуется ƒ(n) времени, то фактическая операция может потребовать время, обозначаемое случайным числом, которое будет максимальным в качестве ƒ(n).

---

Применение структур данных и алгоритмов

Алгоритм  —  это пошаговая процедура, которая определяет набор выполняемых в том или ином порядке инструкций для получения желаемого результата. Алгоритмы обычно создаются независимо от базовых языков программирования, т. е. с возможностью реализации на нескольких языках.

С точки зрения структур данных, важны следующие категории алгоритмов:

• Алгоритм поиска элемента в структуре данных.
• Алгоритм сортировки элементов в определенном порядке.
• Алгоритм вставки элемента в структуру данных.
• Алгоритм изменения имеющегося в структуре данных элемента.
• Алгоритм удаления элемента из структуры данных.

---

Базовая терминология

• Данные — это значения или набор значений.
• Элемент данных — это одиночная единица значений.
• Групповые элементы — это элементы данных, разделенные на подэлементы, называемые групповыми.
• Простейшие элементы — это неделимые элементы данных, которые называются примитивными.
• Атрибут и сущность. Сущность — это то, что содержит определенные атрибуты или свойства, которым могут быть присвоены значения.
• Набор сущностей — это сущности со схожими атрибутами.
• Поле — это одиночная элементарная единица информации, представляющая собой атрибут сущности.
• Запись — это набор значений полей сущности.
• Файл — это совокупность записей сущностей в наборе сущностей.

---

Необходимые условия

Прежде чем приступать к изучению серии руководства, нужно иметь базовое представление о языке программирования C, текстовом редакторе, выполнении программ и т. д.

---

Настройка локальной среды

Уже готовы настроить среду для языка программирования C? Тогда вам понадобятся следующие два инструмента: 1. текстовый редактор и 2. компилятор C.

Текстовый редактор

В текстовом редакторе (например, Windows Notepad, OS Edit command, Brief, Epsilon, EMACS, Vim или Vi) будет набираться программа.

Название и версия текстового редактора в разных операционных системах могут различаться. Так, Notepad используется на Windows, а Vim или Vi  —  на Windows и UNIX.

Файлы, создаваемые с помощью редактора, называются исходными файлами и содержат исходный код программы. Исходные файлы программ на языке С обычно имеют в названии расширение .c.

Чтобы начать программировать, кроме текстового редактора, у вас должно быть достаточно опыта для написания компьютерной программы, сохранения ее в файле, компилирования и выполнения.

Компилятор C

Написанный в исходном файле исходный код является удобным для восприятия человека источником программы. Его нужно скомпилировать, перевести на машинный язык, чтобы процессор мог выполнить программу в соответствии с заданными инструкциями.

Для компиляции исходного кода в конечную исполняемую программу будет использоваться компилятор языка программирования C. Предполагается, что у вас есть о нем ​базовые знания.

Самый используемый и доступный компилятор  —  GNU C/C++. Альтернативный вариант  —  компиляторы от HP или Solaris, если у вас есть соответствующая операционная система (ОС).

А теперь приступим к установке компилятора GNU C/C++ на различные ОС. C и C++ указаны вместе не случайно, ведь компилятор GNU GCC работает на обоих языках программирования.

Установка на UNIX/Linux

Используете ОС UNIX? Тогда проверьте, установлен ли GCC у вас на компьютере, введя в командной строке:

$ gcc -v

Если компилятор GNU уже установлен, должно появиться похожее сообщение:

Using built-in specs.
Target: i386-redhat-linux
Configured with: ../configure --prefix = /usr .......
Thread model: posix
gcc version 4.1.2 20080704 (Red Hat 4.1.2-46)

Если же нет, придется установить GCC самостоятельно (подробные инструкции доступны здесь на англ. яз: https://gcc.gnu.org/install/).

Установка на Mac OS

Проще всего установить GCC, загрузив среду разработки Xcode с сайта Apple и следуя простым инструкциям по установке. После настройки Xcode вы сможете использовать компилятор GNU для C/C++.

Xcode доступен здесь: developer.apple.com/technologies/tools/.

Установка на Windows

Чтобы заполучить GCC на Windows, потребуется установить MinGW. Для этого перейдите на домашнюю страницу MinGW и далее по ссылке на страницу загрузки. Загрузите последнюю версию программы установки MinGW с названием MinGW-<version>.exe.

Обязательный минимум при установке MinWG: gcc-core, gcc-g++, binutils и среда выполнения MinGW  —  но вы можете не ограничиваться этим и установить что-то еще.

Добавьте подкаталог bin из установки MinGW в переменную среды PATH, чтобы указывать эти инструменты в командной строке по их простым именам.

По завершении установки вы сможете запускать из командной строки Windows gcc, g++, ar, ranlib, dlltool и другие инструменты GNU.

Читайте также:

• Deepnote - новая IDE для специалистов по данным
• 5 ловких приемов Xcode для рефакторинга кода
• 5 алгоритмов, которые изменили мир

Читайте нас в Telegram, VK и Яндекс.Дзен

«Тело» Дефектовки. Разделы. Фактическая и сметная стоимость. Тип учёта строки. «Тело» Дефектовки — это всё, что находится между «шапкой» Дефектовки и «итогами»Дефектовки. На представленном ниже рисунке тело Дефектовки начинается со строки 8 и заканчивается  на строке 34, перед строкой «Итого по разделам». Каждая строка в «теле» Дефектовки, так же как и в «итогах», имеет определённый ТИП строки! Что такое ТИП строки и для чего он нужен, читайте на странице Типы строк документа. Это очень важная тема для понимания приёмов безаварийной работы в программе Смета 2007. Разделы Дефектовки В данном случае, на представленном рисунке, наша Дефектовка состоит из 2-ух разделов. Вообще же, количество разделов в Дефектовке ограничивается только размерами листа Excel и соображениями целесообразности.  Но, один раздел в документе Дефектовка должен быть обязательно! Количество разделов Дефектовки можно задать в «Окне свойств» Дефектовки при её создании, а так же добавить дополнительные или удалить лишние в процессе «набора» Дефектовки. Для добавления и удаления разделов в программе предусмотрены специальные кнопки, расположенные в группе «Дефектовка» на вкладке «Смета 2007» ленты Excel. Соответственно, это кнопки: «Добавить раздел» и «Удалить раздел». Удалять разделы «вручную», стадартными средствами Excel, НЕ РЕКОМЕНДУЕТСЯ, дабы не нарушить структуру документа. Нарушение структуры любого документа в программе Смета 2007, может привести к возникновению ошибок при выполнении программой процедур, обращающихся, в процессе выполнения, к «испорченному» документу! Фактическая и сметная стоимость. Коэффициэнт. Как видно из рисунка, документ «Дефектовка» состоит как бы из 2-ух частей, разделённых столбцом серого цвета, содержащим , непонятные буквы «дс«. Их назначение рассмотрим чуть ниже на этой странице. Слева от серого столбца расположены 6 столбцов: «Наименование работ, материалов, затрат», «Единицы измерения», «Количество» и ФАКТИЧЕСКИЕ «Цена» и «Стоимость». Это и есть — собственно «Дефектовка»! Т.к. идея программы состоит в том, чтобы составляя Дефектовку, одновременно составлять и Смету, слева от серого столбца расположены ещё 3 столбца: «Коэффициэнт» и СМЕТНЫЕ «Цена» и «Стоимость». Значения в этих столбцах расчётные, т.е. получены в результате вычислений содержащихся в них формул. Однако, при необходимости, их тоже можно редактировать, корректируя таким образом СМЕТНУЮ стоимость. Подробнее об этом читайте на странице Набор Дефектовки. В ячейках столбца «k» содержится формула, транслирующая значение этого коэффициэнта из соответствующих ячеек в «шапке» документа. Так для строк типа «Расценка» значение коэффициэнта транслируется из ячейки «С1» и равно 1,8, а для строк типа «Материал» и «Механизмы» значение коэффициэнта транслируется из ячейки «С2» и равно 1,04. При помощи этих коэффициэнтов фактическая цена из столбца «Цена» превращается в сметную цену в столбце «Сметная цена». Поскольку в ячейках столбца «k» содержится не значение, а формула, транслирующая это значение из ячейки, содержащий общий для всей дефектовки коэффициэнт, то изменение коэффициэнта в «шапке» документа, немедленно приведёт к изменению коэффициэнта в каждой строке, в которую он транслируется и, как следствие, к изменению «сметной» стоимости в этих строках и, соответственно сметной стоимости вцелом. При этом фактическая стоимость останется неизменной. Если в какой-то конкретной строке, вследствие применения «общего» коэффициэнта, сметная цена формируется не так как вам нужно, вы можете установить для этой строки «свой», отличный от общего, коэффициэнт. При этом следует помнить, что содержащаяся в ячейке формула будет заменена на конкретное значение («свой коэффициэнт») и после этого, изменение «общего» коэффициэнта в «шапке» документа, не будет влиять на данную строку. Тип учёта строки: что такое «дс«, «тс» и «тд«. Теперь рассмотрим столбец серого цвета содержащий непонятные буквы: «дс«, «тс» и «тд«. Эти буквенные обозначения определяют, каким образом и в каких итогах будут учитываться содержащие их строки. Другими словами, эти буквы обозначают ТИП УЧЁТА СТРОКИ, а именно: буквы «дс» означают, что эта строка будет учтена в итогах и Дефектовки, и Сметы. «тс» — эта строка будет учтена только в Смете. «тд» — эта строка будет учтена только в Дефектовке. Поясним на примере, изображённом на рисунке, как это выглядит и зачем это нужно! Итак, в представленном примере, первые три строки «помечены» буквами «дс«, поэтому стоимость, указанная в этих строках, будет учтена и в итогах по Дефектовке, и в итогах по Смете. Стоимость в строке 2.3: «Диск отрезной по металлу», будет учтена только в итогах Сметы, а в итогах по Дефектовке — нет. Как видите, в ячейке, содержащей ФАКТИЧЕСКУЮ стоимость, вообще не указана сумма. Зачем это нужно? Здесь вспомним, что Дефектовка — это документ для расчёта фактических затрат, и в ней мы должны учесть только те затраты, которые действительно будут иметь место и именно по фактической цене. Но, т.к. 15 этих самых отрезных дисков у нас, допустим, уже есть (остались с прошлого объекта), поэтому затраты на их приобретение учитывать в фактических затратах нам не нужно. В то же время, ничто не мешает нам взять с Заказчика (т.е. учесть в Смете) деньги на приобретение этих дисков, т.к. это — вполне обоснованная трата. Таким образом, строка «Диск отрезной по металлу» в Дефектовке не учитывается, но в сформируемую позже Смету эта строка попадёт, со стоимостью 936,00 руб. И наоборот! Строка 2.4: «Болгарка» — затраты на её приобретение учтены в фактических затратах в сумме 5 600,00 руб., т.к. планируя эти работы мы знаем, что для их выполнения нам придётся её купить. Однако, в Смету эта строка не попадёт вовсе (строка помечена буквами «тд«), потому что Болгарка — это средство производства, а не расходный материал, и Заказчик вовсе не обязан покупать для Подрядчика средства производства и прочие основные фонды, поэтому вставлять в Смету строки затрат подобного рода — не правомерно. Как изменить тип учёта строки? Чтобы изменить тип учёта строки, нужно просто сделать двойной щелчёк на ячейке, содержащей обозначение типа учёта строки. В результате программа произведёт необходимую корректировку строки. ТОЛЬКО ТАК! Если просто выделить ячейку и вместо «дс» написать «тс» — ничего не получится, т.к. повторюсь, программа должна должным образом скорректировать строку, и сигналом к этому для неё служит — двойной щелчёк на соответствующей ячейке. В результате двойного щелчка, программа поменяет тип учёта с «дс» на «тд«. При этом ячёйка окажется в режиме редактирования. Чтобы теперь установить тип «тс«, выделите какую-нибудь другую ячейку, потом снова дважды щёлкните на этой ячейке. Если повторить это ещё раз — тип учёта строки будет снова установлен в «дс«.