Веб-версияОткрыть в Telegram
ППоговорим о документации?

Поговорим о документации?

@TechDocIT · группа · Технологии · в индексе с 2026-07-04
1 268участников−8 за неделю
22пишущих за 30 дней
63сообщений за 30 дней
4 189сообщений в индексе
Е
Файл
Вводная_лекция_от_игрушки_до_спутника.pdf · 2.6 МБ · нажмите — покажем
Делюсь презентацией лекции "От игрушки до спутника: технический писатель как двигатель прогресса"
❤3🔥2👍2
  1. A
    Подскажите, входит ли клиентское ПО, например мобильное приложение для управления котлом обогрева дачи, в состав АПК?
    1. Е
      Здравствуйте! Вопрос интересный))) Спасибо за такой вопрос! Я понимаю так: Вы купили АПК "Умный котел" для дачи, для которого производитель выпустил мобильное приложение. И АПК "Умный котел" работает только с этим мобильным приложением. Если мобильное приложение записано на какой-то физический носитель, и вложено в заводскую упаковку вместе с котлом, то "ДА" оно входит в состав АПК "Умный котел". Это аналогично драйверу для принтера. Вы можете скачать драйвер, а можете его установить с диска. Без драйвера принтер не будет совместим с компом/смартфоном. Если мобильное приложение не входит в состав поставки котла, то вы купили "Умный котел", совместимый с таким-то мобильным приложением. В этом случае, приложение в состав "Умного котла" не входит
      1. A
        Точнее, котёл был до меня (с батареями), я купил умное устройство для управления (термостат), в который вставляется сим-карта для соединения с интернетом. Ну и мелочи типа датчика температуры. Приложение предназначено для работы с термостатом, никуда особо не записано, устанавливается из магазина приложений. При этом интересно, что термостатом можно (но неудобно) управлять и без приложения, через SMS (благодаря той же сим-карте). Что скажете с учётом всей этой картины?
      2. D
        Аналогия с драйвером не корректна. Драйвер - это системное ПО. Оно не выполняет прикладной функции, но позволяет устройству функционировать.
          1. D
            По сути вопросов нет, поэтому я виделил драйвер отдельно. Для кого то это может быть важно.
            👍1
            1. Е
              Фотография
              нажмите — покажем
              Доброе утро! Да, есть нюансы. Но если мы скачиваем драйвер только с сайта, и он не входит в поставку изделия (т.е. не записан на диск или иной носитель информации, который входит к комплект поставки), то значит драйвер не включен в состав изделия. Даже в моем примере, вместе с принтером предоставляется ППО, которое помогает установить драйверы. О чем производитель указывает в Руководстве пользователя. В документации на изделие есть (должна быть) вся необходимая информация
Вся ветка · 8 ответов →
D
Курс «Эксперт по экспертам. Продуктивная коммуникация с носителями знания» 📅 Когда: 20–30 октября с 13:00 до 17:00 по МСК  📍 Где: онлайн, записи лекций будут доступны участникам Приглашаем вас на курс Марии Премининой о работе с носителями знания — приходите, чтобы отточить свои навыки общения со SME, прокачать навыки интервьюирования и снять «проклятие знания» с себя и с экспертов.  В программе курса:  ▪️ Подготовка к работе с экспертами. Определение целей и задач. Подготовка вопросов перед интервью. «Проклятие знания» и как его снять.  ▪️ Проведение успешного интервью. Управление ходом беседы. Проверка качества информации и собственных выводов. ▪️ Проверка и анализ полученной информации. Поиск противоречий, дублирования и нестыковок. Работа с неоднозначными формулировками и необоснованными утверждениями. ▪️ Преодоление сложных ситуаций. Способы перевода конфликтов в конструктивное русло. Удержание рабочих границ и конструктивного взаимодействия с экспертами и представителями бизнеса. ▪️ Переход от коммуникации к документации. Превращение знания в структуру документа. Подготовка материала к документированию. Стоимость участия — 40 000 рублей. Доступна оплата в рассрочку через сервис «Долями». 📝 Подробнее узнать о программе курса и оставить заявку:  documentat.io/courses/sme-again
❤3🔥1👏1
2 · 531 ·
J
Е
На бытовом уровне, вы собрали АПК, который не работает (не совсем удобно работает) без приложения. С приложением - у вас полный комплект! В таком исполнении вас больше устраивает. Тогда входит в состав вашего самодельного АПК. Если серьезно, по ГОСТ ЕСКД, то состав изделия определен в спецификации на изделие. Вы сами, как разработчик АПК, определяете состав изделия - входит или не входит.
❤1
  1. A
    А по термостату надо посмотреть документацию, идёт ли приложение в комплекте с ним. Спасибо
    🤝1
Вся ветка · 1 ответ →
A
Согласен насчёт драйвера! По СПО и ППО ситуация разная, с точки зрения состава АПК
E
Добрый день. Сейчас часто идёт аппаратура с инструкцией, в которой указан, например, QR код для скачивания приложения, если она может управляться с устройства с Android или iOS. Либо вариант - указывают ссылку на сайт производителя, чтобы можно было периодически скачивать обновления ПО на аппаратуре. Таким образом полный комплект поставки имеется, просто источник ПО внешний и в общем доступе, а не на дисках или флешках. Если это закрытая разработка, тогда с точки зрения ИБ источник д.б. не в общем доступе, соответственно. Такие моменты в идеале должны закладываться при разработке ТП.
D
«Там всё элементарно»: почему мы не понимаем экспертов — и что с этим делать 📅 Когда: 8 октября в 17:00 по МСК  📍 Где: Youtube, Rutube, VK Видео. Записи будут доступны после окончания лекции Хранитель знаний полчаса объясняет процесс, вы киваете, говорите «понятно», а потом садитесь писать документацию и не можете вспомнить ни одного шага. Знакомо? Хорошая новость — дело не в вашей невнимательности. У этого явления есть научное объяснение, и изучена проблема гораздо лучше, чем можно предположить. В открытой вводной лекции к курсу «Эксперт по экспертам. Продуктивная коммуникация с носителями знания» Мария Преминина расскажет, почему даже самый компетентный специалист объясняет неполно, как за две минуты научиться спрашивать так, чтобы получать честный ответ вместо вежливого, и каким приёмом можно воспользоваться уже на следующем рабочем созвоне. Приглашаем вас на прямой эфир 8 октября — и ждём ваших вопросов в нашем чате t.me/TechDocIT!
🔥9❤4🥰1
6 · 452 ·
  1. S
    Привет. А есть уже прямая ссылка на грядущую трансляцию?
Вся ветка · 2 ответа →
D
Курс по документированию АПК вот-вот начнётся! 📅 Когда: 5–9 октября с 16:00 до 20:00 по МСК  📍 Где: онлайн, записи лекций будут доступны участникам 5 октября стартует курс «Документирование вычислительной техники и аппаратно-программных комплексов» — приходите на первый поток, чтобы изучить наиболее важные группы стандартов, научиться определять состав документации для конкретного проекта и попробовать свои силы в разработке ключевых документов для вычислительной техники и АПК на всех стадиях создания. В программе курса: ▪️ Жизненный цикл продукции и нормативная база. ▪️ Научно-исследовательская работа и постановка требований. ▪️ Опытно-конструкторская работа и разработка документации. ▪️ Производство, эксплуатация и приемка АПК. Стоимость участия — 40 000 рублей. Доступна оплата в рассрочку через сервис «Долями». 📝 Подробнее узнать о программе курса и оставить заявку:  documentat.io/courses/apk
🔥3❤3👏1
409 ·
D
Теперь мы есть и в LinkedIn!  Мы завели страницу в LinkedIn — там мы планируем делиться новостями компании, публиковать вакансии и рассказывать о самом интересном из жизни Documentat.  Переходите по ссылке, присоединяйтесь и оставляйте комментарии — будем на связи!  ➡️ linkedin.com/company/documentat
🔥5❤‍🔥2👍1❤1
2 · 364 ·
D
Открыта запись на курс «Документирование современных ИТ-решений по российским стандартам»! 📅 Когда: 9–13 ноября с 10:00 до 14:00 по МСК  📍 Где: онлайн, записи лекций будут доступны участникам Приглашаем на большой курс про ГОСТ от Михаила Острогорского и Оксаны Гаврюшенко! Курс адресован техническим писателям, аналитикам, архитекторам и руководителям проектов, которые работают с технической документацией в ИТ-проектах. Он даёт полное представление о документировании автоматизированных систем по КСАС (ГОСТ 34) и программных средств по ЕСПД (ГОСТ 19). В программе курса:  📌 Использование стандартов при документировании ИТ-решений. 📌 Основные виды ИТ-продукции в свете документирования. 📌 Документирование автоматизированных систем в соответствии с КСАС. 📌 Документирование программных средств в соответствии с ЕСПД. 📌 Составление отчетной документации. 📌 Организация разработки комплекта документации. 📌 Автоматизация разработки документации по ГОСТ. Стоимость участия — 45 000 рублей. Доступна оплата в рассрочку через сервис «Долями». 📝 Подробнее узнать о программе курса и оставить заявку: documentat.io/courses/gost-in-a-nutshell
❤4🔥2🤯1
1 · 326 ·
D
Уже послезавтра Мария Преминина проведёт открытую лекцию «Там всё элементарно: почему мы не понимаем экспертов — и что с этим делать».  Включайте наш прямой эфир в четверг, 8 октября, чтобы узнать: ▪️ Почему на один и тот же вопрос можно получить либо честный и проверяемый ответ, либо вежливую отговорку. ▪️ Какая философская традиция стоит за привычкой не верить собеседнику на слово и  обязательно разбираться, что тот имеет в виду на самом деле. ▪️ Каким коммуникативным приёмом можно воспользоваться уже на следующем рабочем созвоне. 📅 Когда: 8 октября в 17:00 по МСК  📍 Где: Rutube, VK Видео, Youtube. Записи будут доступны после окончания лекции
5 · 204 ·

Открытая публичная лента из поискового индекса ChatCrawler — «Google по публичному Telegram»; обновляется по мере обхода площадки. Время — UTC.

Только публичный контент, официальный API Telegram. О проекте · Вопросы · Чего мы не делаем · Убрать страницу из выдачи · Каталог · Поиск · Как мы считаем