Документация - Documentation
Документация - это любой передаваемый материал, который используется для описания, объяснения или инструктирования относительно некоторых атрибутов объекта, системы или процедуры, таких как его части, сборка, установка, обслуживание и использование. Документация может быть представлена на бумаге, в Интернете, на цифровых или аналоговых носителях , таких как аудиокассеты или компакт-диски . Примерами являются руководства пользователя, официальные документы, интерактивная справка и краткие справочные руководства. Бумажная или бумажная документация стала менее распространенной. Документация часто распространяется через веб-сайты, программные продукты и другие онлайн-приложения.
Документацию как набор учебных материалов не следует путать с наукой о документации , изучением записи и поиска информации.
Принципы составления документации
Хотя связанные стандарты ISO не так легко доступны для общественности, руководство по этой теме из других источников может служить этой цели. , ,
Разработка документации может включать в себя составление, форматирование, отправку, рассмотрение, утверждение, распространение, повторную публикацию и отслеживание документов и т. Д. И созывается соответствующими СОП в регулирующей отрасли. Это также может включать создание контента с нуля. Документация должна быть удобной для чтения и понимания. Если он слишком длинный и многословный, его могут неправильно понять или проигнорировать. Следует использовать четкие, краткие слова, а предложения должны быть ограничены максимум 15 словами. В документации, предназначенной для широкой аудитории, следует избегать гендерных терминов и культурных предубеждений. В серии процедур шаги должны быть четко пронумерованы. , , ,
Изготовление документации
Технические писатели и корпоративные коммуникаторы - это профессионалы, чья сфера и работа - документация. В идеале технические писатели должны иметь опыт как в предметной области, так и в написании, управлении контентом и информационной архитектуре. Технические писатели чаще сотрудничают с профильными экспертами (SME), такими как инженеры, технические эксперты, медицинские работники и т. Д., Чтобы определить, а затем создать документацию для удовлетворения потребностей пользователя. Корпоративные коммуникации включают другие виды письменной документации, например:
- Маркетинговые коммуникации (MarCom): авторы MarCom стремятся донести ценностное предложение компании через различные печатные, электронные и социальные сети. Эта область корпоративного письма часто связана с ответами на предложения.
- Техническая коммуникация (TechCom): технические писатели документируют продукт или услугу компании. Технические публикации могут включать руководства пользователя, руководства по установке и настройке, а также процедуры устранения неполадок и ремонта.
- Юридическое письмо : этот тип документации часто готовят поверенные или помощники юриста.
- Документация о соответствии: этот тип документации кодифицирует стандартные операционные процедуры (СОП) для любых требований соответствия нормативным требованиям, например, для утверждения безопасности, налогообложения, финансирования, технического утверждения и всего остального.
- Медицинская документация: эта область документации включает в себя своевременную регистрацию и подтверждение событий, произошедших в ходе оказания медицинской помощи.
Документация по информатике
Типы
Ниже приведены типичные типы документации по программному обеспечению:
- Запрос предложений ( RFP )
- Требования / Техническое задание / Объем работ (SOW)
- Дизайн программного обеспечения и функциональные спецификации
- Дизайн системы и функциональные характеристики
- Управление изменениями, отслеживание ошибок и улучшений
- Приемочное тестирование пользователей
- Manpages
Ниже приведены типичные типы аппаратной и сервисной документации:
- Схемы сети
- Карты сети
- Технический паспорт для ИТ-систем (например, сервер, коммутатор)
- Каталог услуг и портфель услуг ( ITIL )
Инструмент Папка документации по программному обеспечению (SDF)
Распространенным типом программного документа, написанного в индустрии моделирования, является SDF. При разработке программного обеспечения для симулятора, который может варьироваться от встроенных устройств авионики до трехмерных баз данных местности посредством систем полного управления движением, инженер ведет блокнот, в котором подробно описывается разработка «сборки» проекта или модуля. Документ может быть вики-страницей, документом MS Word или другой средой. Они должны содержать раздел требований, раздел интерфейса для подробного описания коммуникационного интерфейса программного обеспечения. Часто раздел примечаний используется для подробного подтверждения концепции, а затем для отслеживания ошибок и улучшений. Наконец, раздел тестирования, чтобы задокументировать, как было протестировано программное обеспечение. Это документальное соответствие требованиям клиента. Результатом является подробное описание того, как разработано программное обеспечение, как собрать и установить программное обеспечение на целевом устройстве, а также любые известные дефекты и обходные пути. Этот документ сборки позволяет будущим разработчикам и специалистам по сопровождению своевременно приступить к работе над программным обеспечением, а также предоставляет дорожную карту для изменения кода или поиска ошибок.
Программные инструменты для инвентаризации и настройки сети
Эти программные инструменты могут автоматически собирать данные о вашем сетевом оборудовании. Данные могут быть для инвентаризации и для информации о конфигурации. ITIL библиотека просит создать такую базу данных в качестве основы для всей информации для ИТ отвечает. Это также основа для ИТ-документации. Примеры включают конфигурацию XIA.
Документация в уголовном судопроизводстве
«Документация» - предпочтительный термин для процесса заполнения криминальных баз данных. Примеры включают в себя Национальный Антитеррористического центра «s Террорист идентичностей Datamart Environment („TIDE“), секс обидчика реестров и баз данных банды.
Документация в дошкольном образовании
Документация, относящаяся к области дошкольного образования, - это «когда мы замечаем и ценим детские идеи, мышление, вопросы и теории о мире, а затем собираем следы их работы (рисунки, фотографии детей в действии и стенограммы их слов), чтобы поделиться с более широким сообществом "
Таким образом, документирование - это процесс, используемый для того, чтобы связать знания педагога и обучение ребенка / детей с семьями, другими сотрудниками и даже с самими детьми.
Документация является неотъемлемой частью цикла исследования - наблюдения, размышления, документирования, обмена и ответа.
Педагогическая документация, с точки зрения документации учителя, - это «рассказ учителя о движении в понимании детей». По словам Стефани Кокс Суарес в книге «Документация - трансформация наших перспектив», «учителя считаются исследователями, а документация - это исследовательский инструмент, способствующий развитию знаний среди детей и взрослых».
Документация в классе может принимать разные стили. Ниже приведены примеры того, как документация может сделать «исследование» или обучение видимым:
- Панели документации (презентация в виде доски объявлений с множеством изображений и описаний проекта или мероприятия).
- Ежедневный журнал (журнал, который ведется каждый день и фиксирует игру и обучение в классе)
- Документация, разработанная детьми или вместе с детьми (при наблюдении за детьми во время документирования в реальной документации используется детская линза наблюдения)
- Индивидуальные портфолио (документация, используемая для отслеживания и выделения развития каждого ребенка)
- Электронная документация (использование приложений и устройств для обмена документацией с семьями и соавторами)
- Стенограммы или записи разговоров (использование записи в документации может вызвать более глубокие размышления как у педагога, так и у ребенка)
- Обучающие истории (рассказ, используемый для «описания обучения и помощи детям в понимании себя как сильных учеников»)
- Класс как документация (отражение и документация физической среды в классе).
Документирование - это, безусловно, процесс сам по себе, и это также процесс внутри преподавателя. Ниже описывается процесс разработки документации для самого преподавателя и внутри него:
- Развивайте (и) привычки к документации
- Научитесь публично рассказывать о своих действиях.
- Развивать навыки визуальной грамотности
- Осмыслять цель документации как сделать видимыми стили обучения, и
- Делитесь видимыми теориями для интерпретации и дальнейшего развития учебной программы.
Смотрите также
- Авторская
- Библиографический контроль
- Смени управление
- Указатель цитирования
- авторское право
- Описание
- Документ
- Документация (поле)
- Документация наука
- Идентификатор документа
- Система управления документами
- Документальный
- Свобода информации
- Глоссарий
- Исторический документ
- Указатель (публикация)
- ISO 2384: 1977
- ISO 259: 1984
- ISO 5123: 1984
- ISO 3602: 1989
- ISO 6357: 1985
- ISO 690
- ISO 5964
- ISO 9001
- IEC 61355
- Международное стандартное библиографическое описание
- Журнал документации
- Лицензирование
- Фирменный бланк
- Список содержания
- Техническая документация
- Гид пользователя
- Медицинский сертификат
- Издательский
- Ведение документации
- Документация по программному обеспечению
- Гид по стилю
- Техническая коммуникация
использованная литература
внешние ссылки
- IEEE Professional Communication Society
- Определение документации Linux Information Project (LINFO)
- Информация и документация Список выбранных инструментов
- Библиотека статей по документации: технические статьи и статьи по документации