Рубрика «Подготовка технической документации»

Правила хорошего тона при оформлении технической документации

Правила хорошего тона при оформлении технической документации

Введение

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

Читать полностью »

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

Нужен ли офис конструкторам?

Читать полностью »

Доброго дня всем.

В сегодняшней статье хотел бы поделиться проведенным анализом приложений, потенциально способных заменить MS Visio для разного рода задач.

Откуда возникла такая потребность

На самом деле, я давно работаю в Визио. Еще со студенческих времен рисую там блок-схемы для бизнес-процессов, различных функций и алгоритмов, просто чтобы не запутаться. Это мой must have при разработке сложных частей приложений.

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

Читать полностью »

Отдельная вкладка для просмотра математики в реальном времени
Отдельная вкладка для просмотра математики в реальном времени

Введение

Далее будут описываться способы ускорения набора LaTeX-овского текста, поэтому если Вы не знаете, что такое LaTeX, то Вам придется изучить это самостоятельно (может кто оставит полезные ссылки в комментариях).

Читать полностью »

Как использовать макросы в Confluence, чтобы систематизировать и оформить документацию по продукту и процессам? - 1

Привет! Меня зовут Таня Дудо, и я уже 6 лет помогаю людям и командам обмениваться знаниями внутри компаний. Для этого использую Confluence. Да-да, ту самую wiki-систему, которую часто называют неудобной и несовременной. Сегодня выступлю ее адвокатом-обозревателем: расскажу про 7 полезных макросов для систематизации и оформления контента и наглядно покажу, как они работают.

Дисклеймер: с марта Atlassian не продают лицензии в Россию напрямую. Но если у вас уже есть, никто не запрещает ей пользоваться. На сайте Atlassian есть развернутая документация по установке Confluence и Jira. Она охватывает практически все аспекты. Вот, например, одна из статей.
Читать полностью »

Привет! Меня зовут Юрий Никулин, и я руководитель направления документирования Cloud. Сегодня расскажу, как мы перешли с документирования в Word на подход docs as code и почему в качестве языка разметки выбрали reStructuredText.

Создание системы документирования, или как мы от «ворда» к docs as code за месяц переходили - 1

Почему мы этим занялись

Читать полностью »

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

Язык Dot для Автогенерации Блок Схем Сложных Электронных Цепей - 1

Читать полностью »

У меня не было обложки, поэтому решил засунуть себя)
У меня не было обложки, поэтому решил засунуть себя)

Читать полностью »


https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js