Части Техотчётов

Материал из Брацка Правки
Перейти к: навигация, поиск

Свойства Техотчётов (здесь и далее по тексту -- Лектио) -- это часть урока Суть Техотчётов. В Брацкой Школе, уроки делятся на так называемые лектио, каждое из которых состоит из микролекции и одного или нескольких заключительных вопросов. Урок, в свою очередь, относится к практическому семинару Выбор Профессии.


Материалы

Предшественник этого Лектио -- Что Есть Техотчёт.

Иллюстрации

Текст

Свойства Техотчётов

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

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

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

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

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

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

Удобство пользователя (usability; в русском жаргоне -- "юзабилити") -- это практичность пользованием отчётом для пользователя. Заголовки, разбиение на разделы, названия разделов, длина предложений, количество причастных и деепричастных оборотов, наличие содержания разделов, краткого изложения содержимого отчёта и разъяснения терминов являются элементами удобства пользования.

Не все свойства созданы равными. Своевременность, фактичность и полнота отчёта более важны, чем адресность и удобство пользования.

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

Технические отчёты предназначены для быстрого оповещения исследователей. Быстрота распространения отчётов важнее стилистики и читабельности. Отчёты преследуют различные цели. Они:

  1. Сообщают последние результаты и описывают ход исследований, тестировок, разработок или других проектов,
  2. Служат справочной информацией по возникающей или важной теме,
  3. Предоставляют список инструкций или процедур для текущей практики,
  4. Оценивают применимость, осуществимость и целесообразность внедрения новой технологии и рекомендуют, следует ли продолжать исследования и как оценивать достигнутый прогресс,
  5. Содержат подробные технические характеристики систем, функций, характеристик и работ.

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

  1. Содержимое не публикуется через издательства и обычные коммерческие каналы. Вместо этого отчёты и доклады обнародуются или спонсируются правительственными учреждениями, ассоциациями, обществами, советами, фондами, лабораториями, университетами, некоммерческими и коммерческими предприятиями.
  2. Формат обеспечивает быстрое сообщение результатов новых исследований.
  3. Отчеты рассылаются целевой аудитории напрямую. Они могут содержать специальные термины и могут быть рассчитаны на тех потребителей, которые разбираются в технической стороне вопроса.
  4. Отчеты включают подробную методологию и данные.
  5. Публикации обычно не рецензируются, но иногда являются результатом другого процесса отбора, например, прошли через конкурс, сделаны по контракту или выбраны для обнародования предприятием.
  6. Корпоративное авторство обычно подчеркивается.

Из-за своих целей и характеристик, технические отчёты обыкновенно оказываются сухими и излишне детализованными документами. Чтобы представить данные техотчётов клиентам и другим заинтересованным лицам, предприятия делают на основе технических отчётов доклады (white paper). Доклады -- это уже маркетинговые документы. Они написаны более простым языком, чем отчёты. Доклады могут также содержать заявительные утверждения, то есть, мнения в любом разделе. Технические отчеты, как правило, допускают мнения только в разделе "Истолкования".

Целевые аудитории отчётов и докладов пускай не полностью, но отличаются. Доклады могут использоваться для привлечения внимания к отчётам.

Варианты

Следующее лектио -- Структура Техотчётов

Термины

Отчет

Экзамен

Определения

Вопросы экзамена

Любое описание, которое представляет мнения и предположения о продукте, также может рассматриваться как отчет. -- Правда\неправда