Горячее
Лучшее
Свежее
Подписки
Сообщества
Блоги
Эксперты
Войти
Забыли пароль?
или продолжите с
Создать аккаунт
Я хочу получать рассылки с лучшими постами за неделю
или
Восстановление пароля
Восстановление пароля
Получить код в Telegram
Войти с Яндекс ID Войти через VK ID
Создавая аккаунт, я соглашаюсь с правилами Пикабу и даю согласие на обработку персональных данных.
ПромокодыРаботаКурсыРекламаИгрыПополнение Steam
Пикабу Игры +1000 бесплатных онлайн игр
Герои Войны - микс стратегии и РПГ. Собери лучшую армию и победи всех врагов. В игре 7 различных режимов - как для любителей PvE, так и PvP.

Герои Войны

Стратегии, Мидкорные, Экшены

Играть

Топ прошлой недели

  • AlexKud AlexKud 38 постов
  • SergeyKorsun SergeyKorsun 12 постов
  • SupportHuaport SupportHuaport 5 постов
Посмотреть весь топ

Лучшие посты недели

Рассылка Пикабу: отправляем самые рейтинговые материалы за 7 дней 🔥

Нажимая кнопку «Подписаться на рассылку», я соглашаюсь с Правилами Пикабу и даю согласие на обработку персональных данных.

Спасибо, что подписались!
Пожалуйста, проверьте почту 😊

Помощь Кодекс Пикабу Команда Пикабу Моб. приложение
Правила соцсети О рекомендациях О компании
Промокоды Биг Гик Промокоды Lamoda Промокоды МВидео Промокоды Яндекс Директ Промокоды Отелло Промокоды Aroma Butik Промокоды Яндекс Путешествия Постила Футбол сегодня

Техническая документация

С этим тегом используют

IT IT юмор Программирование Картинка с текстом Все
94 поста сначала свежее
11
Moroshkin51
1 год назад

Крик о помощи!⁠⁠

Всем поздорову!
Я занимаюсь ремонтом складской техники. В частности вилочными погрузчиками, штабелëрами и прочей машинерией, которая по складу бегает и тяжести туда-сюда перемещает. В основу своей работы, как главный принцип я заложил качество и очень стараюсь его поддерживать. Но у меня есть ОГРОМНАЯ проблема с технической документацией на технику (каталоги запчастей, сервис мануалы, инструкции) Что-то я нахожу в сети. На Jung купил программу, но этого очень часто не хватает. Конкретно сейчас мне очень нужен или сервис мануал, или заводская инструкция на погрузчик Still RC40-16 2012г.
Да и в целом если кто-то может подсказать ресурсы, где можно эти мануалы найти, буду признателен.
Так же за годы работы у меня тоже кое что собралось. Готов меняться)
Также готов рассмотреть вариант покупки.

Всем огромное спасибо за внимание.

ООчень прошу поднять в топ.

[моё] Техническая документация Помощь Текст
8
75
imctobitch
imctobitch
1 год назад
IT-юмор
Серия I'm CTO, bitch

Чиназес⁠⁠

Чиназес
[моё] I`m CTO bitch IT юмор Корпоративная культура Знания Словарь Скриншот Зумеры Сленг Telegram каналы Техническая документация
13
9
OneMorePikabuer
OneMorePikabuer
1 год назад

Когда проект вырос и надо писать документацию⁠⁠

Когда проект вырос и надо писать документацию
Техническая документация Программирование Разработка IT
0
14
SanktTehnik.spb
SanktTehnik.spb
1 год назад
Сантехники-слесаря

17 мая 2024 года. КАМЧАТКА, проект⁠⁠

Выполнен проект✍ отопления административного здания площадью 600кв.м.

17 мая 2024 года. КАМЧАТКА, проект Проект, Проектирование, Чертеж, Схема, Инженерия, Техническая документация, Монтаж систем отопления, Отопление, Теплый пол, Длиннопост
17 мая 2024 года. КАМЧАТКА, проект Проект, Проектирование, Чертеж, Схема, Инженерия, Техническая документация, Монтаж систем отопления, Отопление, Теплый пол, Длиннопост
17 мая 2024 года. КАМЧАТКА, проект Проект, Проектирование, Чертеж, Схема, Инженерия, Техническая документация, Монтаж систем отопления, Отопление, Теплый пол, Длиннопост
17 мая 2024 года. КАМЧАТКА, проект Проект, Проектирование, Чертеж, Схема, Инженерия, Техническая документация, Монтаж систем отопления, Отопление, Теплый пол, Длиннопост
17 мая 2024 года. КАМЧАТКА, проект Проект, Проектирование, Чертеж, Схема, Инженерия, Техническая документация, Монтаж систем отопления, Отопление, Теплый пол, Длиннопост
17 мая 2024 года. КАМЧАТКА, проект Проект, Проектирование, Чертеж, Схема, Инженерия, Техническая документация, Монтаж систем отопления, Отопление, Теплый пол, Длиннопост
17 мая 2024 года. КАМЧАТКА, проект Проект, Проектирование, Чертеж, Схема, Инженерия, Техническая документация, Монтаж систем отопления, Отопление, Теплый пол, Длиннопост
17 мая 2024 года. КАМЧАТКА, проект Проект, Проектирование, Чертеж, Схема, Инженерия, Техническая документация, Монтаж систем отопления, Отопление, Теплый пол, Длиннопост
17 мая 2024 года. КАМЧАТКА, проект Проект, Проектирование, Чертеж, Схема, Инженерия, Техническая документация, Монтаж систем отопления, Отопление, Теплый пол, Длиннопост
17 мая 2024 года. КАМЧАТКА, проект Проект, Проектирование, Чертеж, Схема, Инженерия, Техническая документация, Монтаж систем отопления, Отопление, Теплый пол, Длиннопост
Показать полностью 10
[моё] Проект Проектирование Чертеж Схема Инженерия Техническая документация Монтаж систем отопления Отопление Теплый пол Длиннопост
2
TheFounder
TheFounder
1 год назад

Как начать писать документацию в VSCode?⁠⁠

Как начать писать документацию в VSCode? Программирование, IT, Программист, Программа, Гайд, Код, Удаленная работа, Техническая документация

Поговаривают, что в некоторых компаниях сотрудники уже не понимают, что происходит в коде проекта. Де-факто для коллективной работы картография проекта — необходимость, нежели привилегия...

Составление пояснений и комментариев к обширным ИИ-системам — трудоемкая задача, но под небольшие опен-сорс/продакшн проекты есть решение.

AutoDocstring — инструмент, который автоматически создает документацию к коду на основе структуры и комментариев. Экономия времени, согласованность стиля, адекватная читаемость и повышенную точность документации — плюсы этого тула. Выделил нужный блок кода, прожал ctrl+shift+2 — готово.

Просматривать строки документации можно во вкладках, выбирать типы форматов строк, выводить типы параметров через подсказки типов pep484, значения и имена переменных. Внутри поддержка args, kwargs, декораторов, ошибок и типов параметров.

Теперь в утилиту можно добавлять "кастомные" документации. Чтобы использовать собственный шаблон, создайте файл .mustache и укажите путь к нему с помощью конфигурации customTemplatePath.

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

А еще записи могут не соответствовать стандартам или требованиям проекта.

Поэтому редактировать и редактировать. Но для создания костяка описаний инструмент — идеально. AutoDocstring сократит время, затрачиваемое на написание документации, на 30-50%. А еще неплохо так снизит число ошибок в тексте.

Скачать можно с официального сайта Microsoft.

Показать полностью 1
Программирование IT Программист Программа Гайд Код Удаленная работа Техническая документация
1
345
ZZYbeR
1 год назад

Документация на станки HAAS⁠⁠

Нашел тут диск, с трудом вытащил с него все имеющиеся мануалы на английском и русском

может кому надо:

[Lathe Operator]

96-0118 Russian Lathe.pdf

96-8700 English Lathe.pdf

37 641 Кбайт в 2 файлах/файле

[Mill]

96-0117 Russian Mill.pdf

96-8000 English Mill.pdf

46 866 Кбайт в 2 файлах/файле

[Rotary Tailstock]

96-0166 Russian Tailstock.pdf

96-0315 English Rotary.pdf

96-0328 Russian Rotary.pdf

96-5000 English Tailstock.pdf

17 963 Кбайт в 4 файлах/файле

[Service\Electrical Service]

96-0284C English Elec Service.pdf

96-0304 Russian Elec Service.pdf

Electrical Schematics.pdf

41 047 Кбайт в 3 файлах/файле

[Service\Mechanical Service]

96-0283C English Mech Service.pdf

96-0303 Russian Mech Service.pdf

209 464 Кбайт в 2 файлах/файле

Документация на станки HAAS Сервис, ЧПУ, Haas, Токарный станок, Фрезерно-токарный, Фрезерный станок, Техническая документация

Облако Мейл

Диск Гугл

Показать полностью 1
[моё] Сервис ЧПУ Haas Токарный станок Фрезерно-токарный Фрезерный станок Техническая документация
33
1229
PerfectMilter
PerfectMilter
1 год назад

И не поспоришь⁠⁠

И не поспоришь Программирование, IT, Программист, IT юмор, Техническая документация, Stack overflow
Программирование IT Программист IT юмор Техническая документация Stack overflow
77
Партнёрский материал Реклама
specials
specials

Считаете себя киноманом 80 LVL?⁠⁠

Залетайте проверить память и сообразительность → Будет интересно

Киногерои Тест Текст
470
CommaPeriod
CommaPeriod
1 год назад
Серия Непрошеный перевод

Документация не готова, но систему выкатили? Удачи с техподдержкой!⁠⁠

Пост был взят и переведен с Reddit. Приятного чтения!

Вот вам история про моего находчивого менеджера Service Desk, лучшего менеджера, который у меня был за всю айтишную карьеру. Эта история случилась пару лет назад, но мне очень нравится ее рассказывать, так что поделюсь тут.

Если вы работали в Service Desk, то понимаете: для поддержки самое главное в новой системе — документация к ней и контакты для эскалирования. Работает система или нет — вопрос другой, но, чтобы ее поддерживать, НЕОБХОДИМА документация, иначе команда поддержки просто стреляет вслепую и мало что может. Так вот, давайте перенесемся в далекий 2017 год, когда я работал в банке и они выкатывали новую процедуру для заведения кредитной карты (ничего увлекательнее этого предложения вы сегодня уже не прочтете). Мы должны были отвечать на все вопросы по процессу, и ожидалось, что мы хорошо понимаем, как осуществлять процедуру, что может сломаться, как это чинить и т. д. и т. п.

Что ж, мы с радостью этим всем занимаемся для систем, по которым у нас есть документация! Но руководство по этой системе еще только предстояло написать, вечером перед выносом у нас состоялась большая встреча по этому вопросу, и мой менеджер заметил кое-что странное. Пусть он будет М, а проджект-менеджер, ответственный за систему, будет Мудаком.

М: Слушай, Мудак, выглядит, конечно, классно, и я рад, что функциональное и нагрузочное тестирование прошло успешно, но, кажется, у моей команды не хватает документации для поддержки. Где можно найти эту документацию?
Мудак: А, документация еще в работе, но скоро все будет.
Напомню, до выноса осталось двенадцать часов.
М: Ты хочешь сказать, что документация не будет готова к запуску, но мы все равно запускаемся?
Мудак: Если это проблема, мы можем обсудить ее в офлайне, а сейчас давайте вернемся к важным вопросам.

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

И вот настал день выноса, и вся наша команда сидит в ужасе, готовясь к наплыву звонков по поводу системы, о которой мы ничего не знаем. Но... Никаких звонков. Вообще ни единого вопроса по новой системе.

Ничего не понимая, я зашел в кабинет к менеджеру и сказал:
— Ого, наверно, эта новая штука очень понятная, а то нам по ней вообще никто не звонил.
— Точно?
— Ага, прямо ни одного звонка. Что происходит? Ты что-то придумал?
— А ты попробуй прямо при мне позвонить в поддержку.

Этот парень, этот бог итальянских забастовок изменил алгоритм переадресации звонков поддержки так, чтобы первым делом звучало: «Если вы звоните по поводу [новой системы], нажмите 1, и мы переключим вас на поддержку новой системы» — и такие звонки перенаправлялись прямо на рабочий номер проджект-менеджера новой системы. У него уже висела очередь из пятидесяти звонков, и конца им не было видно.

Весь день я замечал, что к моему менеджеру в кабинет ходят какие-то люди, и каждый раз он указывал им на плакат «Правила поддержки Service Desk» (долгая история, но это был официальный распорядок технического отдела, подписанный техническим директором), и первым пунктом там стояло: «Если система не задокументирована, Service Desk ее не поддерживает».

По логике, если Service Desk что-то не поддерживает, следующая линия поддержки — это проджект-менеджер, ответственный за новую систему, по крайней мере, таким дурацким образом работала банковская техподдержка. Если наша третья линия не справлялась, мы обращались к менеджеру, ответственному за проект, и дальше разбиралась их команда. Применив эти два правила, мой менеджер смог убедить своего начальника (технического директора) включить переадресацию звонков по новой системе сразу тому проектному менеджеру.

Документация была готова через два дня, хотя изначально говорили про две недели.

Оригинальный пост shypantellones

Показать полностью
[моё] Перевел сам Служба поддержки Техническая документация Тупость Эффективный менеджер Текст Reddit
26
Посты не найдены
О нас
О Пикабу Контакты Реклама Сообщить об ошибке Сообщить о нарушении законодательства Отзывы и предложения Новости Пикабу Мобильное приложение RSS
Информация
Помощь Кодекс Пикабу Команда Пикабу Конфиденциальность Правила соцсети О рекомендациях О компании
Наши проекты
Блоги Работа Промокоды Игры Курсы
Партнёры
Промокоды Биг Гик Промокоды Lamoda Промокоды Мвидео Промокоды Яндекс Директ Промокоды Отелло Промокоды Aroma Butik Промокоды Яндекс Путешествия Постила Футбол сегодня
На информационном ресурсе Pikabu.ru применяются рекомендательные технологии