Что должна делать программа

Среда программирования это совокупность программ, обеспечивающих технологический цикл разработки программ: анализ, спецификация, проектирование, кодирование (редактирование, компиляция, компоновка), тестирование, отладка.

Базовые компоненты среды

Редактор – средство создания и изменения исходных файлов с текстом программы.

Компилятор – транслирует исходный файл в объектный файл, содержащий команды в машинном коде для конкретного компьютера.

Компоновщик (редактор связей) – собирает объектные файлы программы и формирует исполняемый файл (разрешая внешние ссылки между объектными файлами).

Отладчик – средство управления выполнением исполняемого файла на уровне отдельных операторов программы для диагностики ошибок.

Прочие компоненты среды

Библиотекарь – средство ведения совокупностей объектных файлов (библиотек).

Профилировщик – средство измерения времени выполнения программных компонент для последующей оптимизации критических компонентов.

Люблю женатого! Страдаю! Что делать? (Программа для работы и 7 историй)

Загрузчик – копирует исполняемый файл с диска в память и осуществляет его запуск.

Цикл разработки программы может быть представлен следующей схемой:

Анализ – определение того, что должна делать программа (но не как она это должна делать).

Спецификация – описание требований к программе в формальном виде.

Проектирование – разработка структуры и алгоритма программы.

Кодирование = редактирование + компиляция + компоновка.

Тестирование – подготовка эталонных входных и соответствующих выходных данных (тестов), запуск программы и сравнение полученных данных с эталонными.

Отладка – выявление и исправление ошибок.

Понравилась статья? Добавь ее в закладку (CTRL+D) и не забудь поделиться с друзьями:

Источник: studopedia.ru

Разработка модуля или программы

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

Никлаус Вирт

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

Добиться этого можно разными путями, но результат всегда должен удовлетворять некоторым критериям, а именно:

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

8.1. проектирование архитектуры

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

Сенсационное решение: новый закон в США вынудит раскрыть все секретные программы и ТКП.

Например, если речь идет о функции деления одного числа на другое, требования должны содержать ответ на вопрос: «А что вернет функция, если знаменатель равен нулю?». Однако в требованиях не стоит забывать и об основных задачах функции, которые порой исчезают за многочисленными особыми случаями. Так, например, в требованиях к функции деления необходимо указать, что функция должна выполнять именно деление, по каким правилам оно должно происходить и с какой точностью.

Часто удобно вводить условности, отличающие отдельные требования друг от друга и от пояснений. Хорошей практикой будет использование глагола должен (должна, должны) в каждом требовании, например: «Функция деления должна вернуть нуль в случае, если знаменатель или числитель, или они оба равны нулю». При этом требования могут делиться на разделы, которые описывают различные функции программы и форматы ее взаимодействия с окружением.

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

• Проверить, что если числитель равен нулю, а знаменатель не равен нулю, то функция возвращает нуль.
• Проверить, что если числитель не равен нулю, а знаменатель равен нулю, то функция возвращает нуль.
• Проверить, что если числитель равен нулю и знаменатель равен нулю, то функция возвращает нуль.

Далее по требованиям и тест-требованиям формируют тест-план, а на его основе уже реализуют сами тестовые примеры.

По требованиям разрабатывается архитектура ПО, определяющая все модули, функции, их интерфейсы, а также алгоритмы работы и структуры данных. Можно сказать, что архитектура ПО должна отвечать на вопрос «КАК работает программа?», в то время как требования к ПО отвечают на вопрос «ЧТО должна делать программа?». Лишь после разработки архитектуры можно приступать к кодированию. На этом этапе происходит воплощение архитектуры в виде программного кода на выбранном языке программирования с учетом всех его особенностей и возможностей. При кодировании необходимо учитывать не только свойства языка программирования, но и особенности выбранной архитектуры целевой машины.

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

8.2. Внешнее взаимодействие

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

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

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

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

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

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

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

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

Вопросы и задачи для самостоятельного решения

• Каковы критерии разделения программы на модули?
• Как следует формулировать требования, чтобы они отличались от пояснений?
• Как следует формулировать описание тест-требований?
• Какой документ отвечает на вопрос: «Что должна делать программа?»
• Какие виды диалогов с пользователем Вам известны?

Источник: intuit.ru

Что такое гайд и правила его составления

Слово «гайд» было заимствовано из английского языка «guide» и по смыслу включает сразу несколько значений: путеводитель, экскурсовод, справочник, гид, мануал. В русском языке есть 2 варианта термина:

1. Гид – это профессионал, который занимается проведением экскурсионных мероприятий.
2. Гайд – это своего рода инструкция, которая может быть составлена для любой ниши.

Первоначально слово использовалось среди геймеров, и только потом “гайд” вошел в различные деятельности в онлайн пространстве.

Что такое гайд

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

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

Гайд может решать следующие задачи:

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

Какими бывают гайды

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

По формату отметить следующие:

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

По методу подачи информации:

• Статья. Руководство, в котором могут присутствовать картинки, таблицы, графики;
• Видео. Может быть в форме длинных или коротких роликов, где даются пояснения касательно темы;
• Инфографика. Используется преимущественно для отправки рассылок, постов в социальных сетях.

Применение гайдов в разных сферах

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

Геймерские гайды

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

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

Условно можно разделить руководства по играм:

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

Гайды в маркетинге

Маркетинговая ниша предполагает такие виды инструкций:

• Для проведения исследований. Может включать план для группового мероприятия или в индивидуальном порядке;
• Гайдлайн, или guideline. Это документ, содержащий техническую информацию, как правильно использовать бренд и стиль компании в различных продуктах;
• Кат-гайд или cut guide. Инструкция, в которой описаны все действия, чтобы реализовать процесс: как создать сайт, дизайнерский проект для отделки помещения.

Гайды в IT-индустрии

В IT-индустрии гайд – это инструкция или руководство по существующим технологиям. Особенно полезны для новичков, которые только пытаются разобраться в терминологии или порядке действий. Для профессионалов это инструкция по применению нового оборудования.

Советы для создания качественного гайда

Может показаться, что создание полезного гайда довольно простая задача.

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

1. В инструкции должна прослеживаться последовательность. Гайд предполагает уточнение каждого шага с упрощенными этапами. Мануал создается с самого начала. Например, чтобы написать грамотную статью «Как правильно использовать Фотошоп», стоит начать с инструментов и пространства для работы. Иначе новичку будет сложно отследить логику. Скорее всего он запутается какие кнопки нажимать.
2. Понимание конкретного результата. После прочтения гайда, пользователь должен выполнить перечень действий из инструкции. Соответственно, гайд должен привести человека к получению результата.
3. Вся информация отображается в конкретных фактах, никакой «воды». Читатель использует инструкцию, чтобы поскорее справиться с какой-то задачей, поэтому философии здесь не должно быть. Когда нужна дополнительная информация, просто используйте ссылку.
4. Подача материала должна рассчитываться на определенный круг пользователей. Перед написанием нужно понимать, на какую целевую аудиторию она рассчитана: на экспертов или новичков. Чем ниже первоначальный уровень знаний, тем подробнее должна быть инструкция. Лучше всего сделать гайд полным и интересным именно для вашей ЦА, часть руководства можно будет посвятить новостям или популярным темам.
5. Используйте иллюстрации, на которых будут повторяться поэтапные действия:
6. рецептах. Можно зафиксировать каждый этап приготовления на снимках;
7. в прохождении игр. Используйте скрины, на которых персонаж совершает необходимые действия;
8. гайд по использованию. Можно создать видеоролик, где показано, как правильно использовать инструментарий;
9. решение задачи. Представлено несколько практик, полезных для читателя.

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

Как правильно написать гайд

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

Чтобы получился полезный для пользователей гайд, выполняйте шаги:

1. Определение ЦА. Нужно решить, на кого будет ориентирован гид: новичков, профессионалов или экспертов. Пользователи также могут отличаться по возрасту, полу, работать в различных проектах. Нужно найти актуальный и полезный материал. Если вы пишите для большого сайта — посмотрите ранние статьи: какие темы уже рассматривали, какие приемы используют авторы и на что подписчики оставляют комментарии, есть ли новости.
2. Выбор тематики. Вне зависимости от того, решаете вы написать длинный один гайд или серию коротких, применяйте матрицу контента, изучайте работы конкурентов, внедряйте свои фишки, добавляйте картинки, инфографику, тексты.
3. Подробно изучите тему, используйте личный опыт. Если вы не является профессионалом в данной теме, в первую очередь максимально подробно изучите тематику, отдайте материал на проверку эксперту.
4. Составьте грамотный и подробный план. Здесь нужно в тезисах расписать план по решению задачи:
5. проблематика;
6. насколько актуальна выбранная тематика;
7. какие могут быть сложности и распространенные ошибки;
8. как можно решить поставленную задачу;
9. результат.
10. Объем материала. Главное задание – это подробно ответить на пользовательские вопросы лишней философии.
11. Использование визуального контента. Инструкция будет выглядеть полной, если добавлять скрины, схемы, рисунки. Чем больше вспомогательных материалов, тем проще пользователю разобраться в данном вопросе.

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

1. Понятен ли каждый пункт?
2. Не переполнен ли текст сложными терминами?
3. Правильно ли определены этапы?
4. Подробно ли раскрыта тематика в текстовом содержании или видео?
5. Нет ли воды и бесполезной информации?
6. Надо ли избавиться от лишних кадров?
7. Нужно ли добавлять другие ссылки с дополнительной информацией?
8. Надо ли разбить большой этап на несколько маленьких?

Когда работа полностью готова, отправьте его на проверку в один из сервисов. В первую очередь нужно проверить на антиплагиат. С этой задачей помогут справиться Advego, Text.ru, Etxt. Далее проверяйте грамотности при помощи Главвреда, Орфограммки, ОРФО. Последний пункт – это тошнота и вода.

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

Чтобы создать качественный гайд, посмотрите примеры. Лучшие гайды:

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

Если не определен конечный результат, гайд теряет смысл.

Ошибки при создании гайда

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

• Ошибка в определении ЦА. Читатели могут не понять информацию, либо перестанут ее читать, так как уже имеют в своем багаже эти знания;
• Недостаточное раскрытие тематики. По прочтению человек не может справиться с поставленной задачей;
• Текст не структурирован, сложно воспринимается;
• Нет никаких скринов и изображений, поэтому человек не понимает, каким образом ему использовать новую информацию;
• Отсутствие конечного результата. Тогда пользователь не понимает, какие проблемы решает данный гайд;
• Не все шаги учтены. На каком-то этапе читатель не может прийти к промежуточному результату и в результат ене может прийти к решению общей задачи;
• Материал не был проверен. В результате читатель может испортить дорогостоящее оборудование или в лучшем случае не сможет решить проблему.

Часто задаваемые вопросы

Обзор – это рассмотрение самого продукта, его характеристик и каких-то качеств. А гайд – это инструкция по использованию с четко обозначенными действиями. Для описания сути обзора больше подходит слово «Что», а для гайда – «Как».

Продвижение гайда можно организовать через:

• Посредством SEO на сайте или блоге, чтобы статья отображалась в поисковике;
• В социальных сетях: создавайте публикации, обновляйте сторисы, выкладывайте видео, заказывайте рекламу у блоггеров;
• На сайтах партнеров, где можно опубликовать гайд, например, на маркетплейсе;
• Создавайте email рассылки. Важно найти данные своей аудитории.

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

Главное, чтобы объема было достаточно для получения ожидаемого результата. Но учтите, что раздумья только навредят — пишите кратко и лаконично. Пользователь должен потратить минимум времени на гайд, это некая карта с указаниями, чтобы достичь результата.

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

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

Заключение

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

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

Источник: neiros.ru