Какие есть требования по оформлению перечислений в документах

Разработчики документации регулярно сталкиваются с такими вопросами: Какой тип списка выбрать? Сколько уровней вложенности может быть у списков в документации? Как маркировать или нумеровать уровни многоуровневых списков? 1. Ключевые моменты В качестве основных целей составления технического документа можно выделить: Список – это не совсем верный термин. Правильный термин: перечисление. Перечисление – это структурный элемент документа.…

Как правильно писать и вести документацию?

В статье рассматриваются следующие основные вопросы: Каких целей достигает хорошо написанный документ? Что позволяет считать документ хорошим? Как составить хороший документ? Каких целей достигает хорошо написанный документ? В качестве основных целей составления технического документа можно выделить: Обучение конечных пользователей и сотрудников продукту компании. Формирование справочных материалов и баз знаний по продукту компании. Снижение нагрузки на…

Авторизация и аутентификация – разбираемся в понятиях

В мире IT используются следующие термины: регистрация; идентификация; аутентификация; авторизация; вход в систему. Некоторые разработчики документации путают эти термины. Поэтому документация получается не очень высокого качества. Давайте выясним, чем отличаются эти термины. Регистрация Сначала выполняется регистрация – создание учетной записи пользователя. Пользователь открывает форму регистрации и заполняет данные о себе (в том числе логин и…

Правила оформления схем по ГОСТ и др.

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

Частые Вопросы о включении в Реестр российского программного обеспечения

Что нужно знать, чтобы попасть в Единый реестр отечественного программного обеспечения (ПО). Рассказываем… Что такое реестр отечественного ПО? Реестр отечественного ПО – справочник программ, разработанных на территории Российской Федерации. Такие программы используются государственными органами или компаниями с государственным участием. Существует два реестра ПО: Единый реестр российских программ для электронных вычислительных машин и баз данных (реестр…