Найти в Дзене
О документах

О документах

Подборка материалов о создании документации
подборка · 6 материалов
633 читали · 2 года назад
Пояснительная записка по ГОСТ
По какому принципу делается любая пояснительная записка, какая информация там должна быть, где ее взять - было здесь. Теперь разберемся, как уложить добытую информацию в документ: как организовать структуру документа в зависимости от того, для какого объекта делается пояснительная записка. Для этого мы будем использовать требования Российских стандартов. Существует несколько систем ГОСТ, в которых приведены требования к пояснительным запискам: 1. Пояснительная записка программы делается в соответствии с единой системой программной документации (ГОСТ 19, ЕСПД)...
2027 читали · 2 года назад
Как писать пояснительную записку к проекту
В этой статье я расскажу, как техническому писателю сделать один из основных проектных документов - пояснительную записку. Для того, чтобы сделать хороший документ, нужно понимать, о чем этот документ должен быть. Основное назначение пояснительной записки - описать проектируемый объект в целом: кратко о том, какой он должен быть и подробно о том, как это будет достигнуто. Выделим то, что должно быть именно в пояснительной записке любого вида проекта: Такое разделение документа на две части - логическое...
115 читали · 2 года назад
Как сделать титульный лист к документу
Что писать на титульном листе помимо названия документа? Как лучше его оформить? Титульный лист не нумеруется, но на следующем листе должен стоять номер страницы с учетом наличия титульного листа, т.е. - 2. Минимальный текст, который должен быть на титульном листе - название документа. Какая еще атрибутика может быть полезна на титульном листе? Рассмотрим различные варианты выполнения титульных листов, в зависимости от назначения документа. Вы делаете отчет на работе, либо другой документ, к оформлению которого нет требований В общем, документ по сути в свободной форме...
Правила создания хороших текстовых документов
Вы умеете делать текстовые документы, в которых легко ориентироваться и которые легко понимать? Нюансов здесь много, ловите основные принципы, сохраняйте, соблюдайте, повышайте уровень культуры документирования нашей страны :) Принцип 1...
Что такое API и зачем его описывают?
API - application programming interface, программный интерфейс приложения. У приложений может быть два вида интерфейсов: пользовательский и программный. В пользовательском интерфейсе все кнопки и текстовые поля подписаны, чтобы пользователю было понятно, что нужно нажать и куда вводить текст. Каждая кнопка и текстовое поле - это способ взаимодействия программы с пользователем. Программный интерфейс - это набор методов для взаимодействия одного приложения с другим. У API нет кнопок и полей, у него есть методы...
Контроль качества технической документации. Этот пост о типичных ошибках, которые допускаются при составлении технической документации. Многие ошибки обусловлены просто невнимательностью. Итак, вот некоторые моменты, на которые нужно обратить внимание: ✔️Название системы должно полностью совпадать с контрактом или другим официальным документом, инициирующим разработку. Если в этом документе используется и полное и сокращенное название системы, то следует выбрать один вариант и использовать только его во всей документации. ✔️Когда упоминается Заказчик, нужно использовать официальное название компании и оно должно совпадать с тем, что прописано в контракте. ✔️Обозначения/наименования компонентов системы, которые упоминаются в описательной части, должны совпадать с обозначением в спецификации. ✔️Децимальный номер проекта должен быть одинаковым везде. Вариант, когда в одном месте АБВГ.1245668.С5, а в другом АБВГ-12345668.С5 недопустим. ✔️Если подрядчик нанимает субподрядчика, то в документации, которая готовится подрядчиком для заказчика это никак не должно отражаться, если иное не прописано в контракте. То есть, нанимая субподрядчика нужно сразу донести до него, что в документации всё должно выглядеть так, как будто это разработано подрядчиком, т.к. контракт заключён с ним и ответственность за разработку перед заказчиком несёт он. ⠀ В карусели пояснительные картинки👉