Документация не готова, но систему выкатили? Удачи с техподдержкой!
Пост был взят и переведен с Reddit. Приятного чтения!
Вот вам история про моего находчивого менеджера Service Desk, лучшего менеджера, который у меня был за всю айтишную карьеру. Эта история случилась пару лет назад, но мне очень нравится ее рассказывать, так что поделюсь тут.
Если вы работали в Service Desk, то понимаете: для поддержки самое главное в новой системе — документация к ней и контакты для эскалирования. Работает система или нет — вопрос другой, но, чтобы ее поддерживать, НЕОБХОДИМА документация, иначе команда поддержки просто стреляет вслепую и мало что может. Так вот, давайте перенесемся в далекий 2017 год, когда я работал в банке и они выкатывали новую процедуру для заведения кредитной карты (ничего увлекательнее этого предложения вы сегодня уже не прочтете). Мы должны были отвечать на все вопросы по процессу, и ожидалось, что мы хорошо понимаем, как осуществлять процедуру, что может сломаться, как это чинить и т. д. и т. п.
Что ж, мы с радостью этим всем занимаемся для систем, по которым у нас есть документация! Но руководство по этой системе еще только предстояло написать, вечером перед выносом у нас состоялась большая встреча по этому вопросу, и мой менеджер заметил кое-что странное. Пусть он будет М, а проджект-менеджер, ответственный за систему, будет Мудаком.
М: Слушай, Мудак, выглядит, конечно, классно, и я рад, что функциональное и нагрузочное тестирование прошло успешно, но, кажется, у моей команды не хватает документации для поддержки. Где можно найти эту документацию?
Мудак: А, документация еще в работе, но скоро все будет.
Напомню, до выноса осталось двенадцать часов.
М: Ты хочешь сказать, что документация не будет готова к запуску, но мы все равно запускаемся?
Мудак: Если это проблема, мы можем обсудить ее в офлайне, а сейчас давайте вернемся к важным вопросам.
Их разговор на этом и заглох, и никакого обсуждения в офлайне не предвиделось, но фактически моему менеджеру сказали, что его команда ничего не значит, и он разозлился. И этот потрясающий человек поступил единственно правильным для себя образом.
И вот настал день выноса, и вся наша команда сидит в ужасе, готовясь к наплыву звонков по поводу системы, о которой мы ничего не знаем. Но... Никаких звонков. Вообще ни единого вопроса по новой системе.
Ничего не понимая, я зашел в кабинет к менеджеру и сказал:
— Ого, наверно, эта новая штука очень понятная, а то нам по ней вообще никто не звонил.
— Точно?
— Ага, прямо ни одного звонка. Что происходит? Ты что-то придумал?
— А ты попробуй прямо при мне позвонить в поддержку.
Этот парень, этот бог итальянских забастовок изменил алгоритм переадресации звонков поддержки так, чтобы первым делом звучало: «Если вы звоните по поводу [новой системы], нажмите 1, и мы переключим вас на поддержку новой системы» — и такие звонки перенаправлялись прямо на рабочий номер проджект-менеджера новой системы. У него уже висела очередь из пятидесяти звонков, и конца им не было видно.
Весь день я замечал, что к моему менеджеру в кабинет ходят какие-то люди, и каждый раз он указывал им на плакат «Правила поддержки Service Desk» (долгая история, но это был официальный распорядок технического отдела, подписанный техническим директором), и первым пунктом там стояло: «Если система не задокументирована, Service Desk ее не поддерживает».
По логике, если Service Desk что-то не поддерживает, следующая линия поддержки — это проджект-менеджер, ответственный за новую систему, по крайней мере, таким дурацким образом работала банковская техподдержка. Если наша третья линия не справлялась, мы обращались к менеджеру, ответственному за проект, и дальше разбиралась их команда. Применив эти два правила, мой менеджер смог убедить своего начальника (технического директора) включить переадресацию звонков по новой системе сразу тому проектному менеджеру.
Документация была готова через два дня, хотя изначально говорили про две недели.
Долой бумажную волокиту! Ученые ПНИПУ разработали программу для написания технической документации
Большинство работников регулярно сталкивается с рутинной, но очень нужной работой с документами. На написание технических заданий, отчетов и прочих проектов со множеством формальных правил тратится большое количество человеческих и временных ресурсов. Ученые Пермского Политеха разработали интеллектуальную систему помощи «Техдок менеджер», которая быстро и точно создает документацию по заданным правилам за секунды. Современные нейросети не умеют следовать четким стандартам, таким как ГОСТ, результаты их работы требуют тщательной проверки в отличие от программы политехников. Она поможет исключить фактор человеческой ошибки, ускорить работу и автоматизировать шаблонные процессы.
На разработку выдано свидетельство №2024612000.
Для написания технической документации компании чаще всего нанимают отдельных специалистов – технических писателей. Они разрабатывают инструкции по эксплуатации, руководства пользователя, отчеты и другие материалы, которые помогают понять и использовать различные продукты, технологии или услуги. Еще такие люди пишут документы технической спецификации, больше ориентированные на разработчиков или отчетность. Помимо самого написания требуется соблюдать определенные правила и ГОСТы.
Но не только технические писатели сталкиваются с подобной задачей. В обязанности многих сотрудников входит ведение документации, особенно в государственных организациях. Например, преподаватели в своей практике часто встречаются с необходимостью формирования целого перечня документов: рабочая программа дисциплины, методические указания к лабораторным и практическим работам, фонд оценочных средств.
Ученые Пермского Политеха разработали программу для компьютеров «Техдок менеджер» – это интеллектуальная система помощи техническому писателю. Программа помогает избежать человеческих ошибок (что-то пропустить или перепутать), «интеллектуально» отслеживает даты, термины и прочее. Автоматизирует рутинные процессы и ускоряет документооборот. «Техдок менеджер» может сам следить за выполнением плана работ над проектом без внесения дополнительных данных. «Помощник» легко модифицируется и настраивается под различные задачи и создает множество альтернативных решений.
Логика разработанной программы построена на классификации и кластеризации текстов различной длины, поиске и распознавании сущностей (конкретные объекты или понятия, которые имеют уникальное имя и могут быть идентифицированы в тексте, например, имена людей, названия организаций, даты и т.д.). «Техдок менеджер» извлекает и систематизирует факты из текста, собирает данные для обработки и понимания естественного языка. Он выявляет содержательные, логические и фактические ошибки, а еще распознает литературные приемы и стили. В итоге синтезирует человеко-читаемый текст на основе выявленной ранее информации и запросов пользователей.
– Ключевая задача нашей программы в том, чтобы одни документы или их части, содержательно зависимые от других, заполнить автоматически. Например, из техзадания органично вытекает технический проект. Его большую часть можно автоматически составить как заготовку документа, но человек должен внести правки. От них уже зависит, например, содержание таких частей как «Введение», «Заключение» и «Список использованных источников». Их можно отредактировать автоматически, – поделился кандидат технических наук, доцент кафедры информационных технологий и автоматизированных систем Даниил Курушин.
Средств автоматизации разработки документации достаточно много, но они чаще всего ориентированы на решение других проблем. Например, современные нейросети способны выполнять рерайтинг и синтез текста, однако результат их работы требует проверки, поскольку они не созданы для работы по стандартам ГОСТ. Разработка ученых ПНИПУ отличается тем, что использует синтез нейронных сетей и специального метода моделирования данных.
– «Помощник техническому писателю» формируется как интерфейс к разрабатываемым нами микропрограммам, скриптам, автоматизирующим работу специалиста. Сначала возникло понимание, что, например, вопросы к курсу лекций можно не сочинять, а написать программу, которая сгенерирует их вместе с вариантами правильных и неправильных ответов. Разумеется, планируется использовать и современные языковые модели, такие как GPT и другие генеративные сети. Также предполагается работа по автоматизированному составлению словарей и справочников, – рассказывает Даниил Курушин.
Программа будет реализована в виде веб-приложения (сайта). Для создания готового текста пользователю необходимо выбрать стандарт, этап и тип документа, который необходимо сформировать, а также написать в окно чата запрос с уточняющими деталями.
«Техдок менеджер» поможет избавиться от рутинной работы. Сейчас ученые Пермского Политеха сами пользуются программой, а в течение года обещают выпустить полноценный продукт для пользователя. Помощника можно будет применять в сфере образования, при разработке продуктов и для сопровождения программного обеспечения.
Платформы для онлайн-обучения: что вы о них думаете? Поделитесь мнением!
Онлайн-курсов становится все больше, и нам интересно собрать статистику. Пожалуйста, пройдите небольшой опрос и поделитесь своим мнением!
Сертификат соответствия
Друзья, требуется ваша помощь. Знакомая попала в трудную ситуацию. Ей очень нужен сертификат соответствия на авто FAW X80, 2020г.в. И так называемая оммологация, или что-то в этом роде. По возможности и то и другое. Необходимо для постановки авто на учёт за границей. Без этих бумажек на учёт не поставят и человек останется без машины. Она уже обращалась к ОД и в ГАИ, но там её бортуют, говорят что не могут выдать, и т.д. Может кто то является владельцем данной модели или может достать эти бумажки. Сила Пикабу, помоги!!!
Без рейтинга, просто очень нужно.
Усё готово, шеф!
Документация проектов SQL
Уважаемые,
Начала работать недавно техподдержкой SAP BO: модули, спецподгонка и много много SQL.
По вашему опыту, как лучше всего документировать проекты, чтоб через некоторое время не смотреть, как баран на новые ворота, а быстро понять, что я там полгода назад навертела?
Заранее спасибо!
Делаем игру по ночам и в выходные (3)
Уважаю лигу лени, вкратце напомню, что мы делаем текстов-графическую игру в виде современного мобильного приложения. То есть сама концепция игры, не из игростроя, а от мобильных приложений которыми мы пользуемся каждый день, ну там банкинг, такси и всё такое. Открыл, потыкал, закрыл.
Сегодня расскажу немного про механики и как мы ведём документацию.
Так как в игре есть крафт и он эпический. Я завёл ноушен и описал всё что можно, что из чего делается, к чему относится, где добывается и зачем нужен. Выглядит это, как таблица на 400 строк.
Затем были заведены страницы станков, на которы это всё добро крафтится, и уже там залинковано с таблицей, чтоб хоть от туда, хоть отсюда, можно было свести концы с концами.
Часть предметов связаны с локациями, квестами и NPC персонажами. Это всё так же закручивается в ноушене в узелок. Локации связаны с персонажами, те с диалогами, диалоги с квестами, квесты с предметами. Сущий ад.
Диалоги так же описываются в ноушене по каждому персонажу со всеми ответвлениями и ответами ГГ.
В прошлый раз, многие взялись читать тексты со скриншотов, чего я не планировал. Заслуженно получил каментов в духе "В игре, которая базируется на тексте - не должно быть ошибок типа "от туда"." Ну собственно, урок мы не усвоили и написали целую документацию из ошибок с ошибками. То ли будет, когда мы это скодим, муахаха!
Ладно, если без шуток, когда я допишу все диалоги, я найму корректора и редактора. Смысл диалогов сейчас не в их содержании, а в наличии. Они должны отработать ситуацию, взять ГГ и дать ему вектор. Что именно будет в самом диалоге, на данном этапе значения не имеет. Главное, что ГГ выйдет с предметом, квестом, новой открытой локацией или механикой из диалога.
Кстати про механики. Так как в игре эпический крафт говна из говна, задумана механика продажи сего говна любителям говна. У нас всё таки мультиплеер.
Механик торговли аж 4 штуки. Во первых есть Скупщик – главный источник денег в игре, так как они не падают с мобов и ящиков. Прикол его в том, что он покупает что угодно, но только за й монету. В целом можно назвать игру "Инфляция", что будет корректно. На первых порах, денег у игроков не будет совсем. У первых игроков меч будет стоить 3 монеты с рук, что покажется конской ценой. Через год, меч будет стоить 1000 монет, и это будет практически даром.
Вторая механика, призвана покупать, а главное продавать через брокера (возможно не совсем корректно, но другого названия ему я не придумал). Ты открываешь счёт, тебе дают 10 ячеек, ты наваливаешь в них лута по своей цене и он попадает в листинг. В целом такие механики есть в ряде игр, том же ЭлдерСкрол Онлайн. Брокер стрижёт проценты с продаж, изымая монеты из игры.
Если ещё не утомились читать, расскажу про третью, это Блошинный рынок. По факту локальный чат, где можно крикнуть что продаёшь, или чего покупаешь, и поторговать напрямую. Не очень эффективно, но в меру весело.
Четвертая механика "Персональные магазины", там можно продавать предметы которые не берёт Брокер и ещё куча всего, что так быстро одним скрином и не покажешь.
Короче, работа идёт. На меня когда-то подписалось 30-40 человек, после первых постов. Им привет, если они ещё тут.
Телеги нет. Денег лично мне не надо. Но если хотите задонатить школьнице девушке иллюстратору, которая бахнула 400 иконок предметов для этой игры, останавливать вас не стану.
ДИЗАЙНЕРЫ И АРХИТЕКТОРЫ, ПОМОГИТЕ С ТЕМОЙ ДИПЛОМА!!!!
Всем привет! Учусь в университете на дизайнера среды, уже очень скоро сдавать диплом. Для него нужно сделать проект дизайна интерьера и прилегающей территории гостиницы/отеля/гостиничного комплекса. Мне требуется какая-то минимальная информация об объекте (проектные чертежи, обмерные планы, название и местоположение) В общем любая база, на основе которой можно создать свой проект. Поэтому если у вас имелись какие-то проекты по гостиницам или отелям, буду безмерно благодарна содействию!
Не знаю, как работает пикабу, поэтому оставляю свои контакты для связи через почту
ann_tyl2001@Mail.ru