Pull to refresh
37
0
Дмитрий Миронюк @Dmitriy_Mironiuk

Технический писатель

Send message

Docs as Code. Часть 1: автоматизируем обновление

Reading time8 min
Views10K


В больших проектах, состоящих из десятков и сотен взаимодействующих сервисов, всё чаще становится обязательным подход к документации как к коду — docs as code.


Я покажу, как можно применять эту философию в реалиях classified-сервиса, а точнее, начну с первого этапа её внедрения: автоматизации обновления данных в документации.

Читать дальше →
Total votes 39: ↑37 and ↓2+35
Comments1

Relax, take IT easy: как вернуть спокойствие в работу. Три инструмента специально для айтишников

Reading time11 min
Views15K

Привет! Я – Ольга Красильникова. У меня за плечами 18 лет работы в сфере управления и развития персонала в компаниях Евросеть, М.Видео, Yota, МТС, Coca-Cola, Heineken. Сейчас работаю менеджером по обучению в Bercut. А еще я карьерный психолог, коуч (более 800 часов коучинговой практики). Верю, что любая работа может стать ресурсом для человека.

За последний год я провела больше 400 карьерных консультаций и коуч-сессий (как внутри компании, так и в частной практике), и вот фразы, которые я слышала почти в каждой сессии:

• «ненавижу свою работу»;
• «как же меня бесят мои коллеги»;
• «мой руководитель – идиот»;
• «мне все это надоело, это никому не нужно»;
• «сил нет больше терпеть».

Как сделать так, чтобы энергии, спокойствия и счастья в работе было больше, даже если сейчас много усталости и хочется бросить все? И что может помочь бизнесу удерживать, развивать и вовлекать ИТ-специалистов?

В своей публикации расскажу, как люди сами создают себе ад на работе и как сами могут себе помочь. Дам три полезных инструмента, позволяющие управлять замкнутыми кругами, в которые многие из нас время от времени попадают. А в конце –бонус.

Читать далее
Total votes 24: ↑19 and ↓5+16
Comments9

Совершенные числа. Удивительная история поисков сверкающих звёзд в бесконечном числовом мире

Reading time7 min
Views21K

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

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

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

Что же в них такого особенного?
Total votes 51: ↑48 and ↓3+59
Comments12

Когда программы были маленькими, а деревья пиксельными. Простота и минимализм TreePad

Reading time4 min
Views13K

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

Для меня таким старым надёжным другом стала программа TreePad Lite. Она со мной уже без малого 30 лет. Мне очень близок минимализм TreePad: простота интерфейса, отсутствие необходимости установки, нетребовательность к ресурсам, открытый формат файлов, отсутствие каких-либо зависимостей от сторонних библиотек и интернета.

Читать далее
Total votes 43: ↑42 and ↓1+53
Comments112

Метаморфозы сознания. Про ревью и комментарии в технической документации

Reading time9 min
Views3.8K

Привет! Меня зовут Дмитрий Миронюк, я старший технический писатель в компании Bercut. До этого работал системным администратором, специалистом внедрения и поддержки, программировал IP-телефонию, успел поработать тимлидом. Но как в итоге стал техническим писателем расскажу в другой раз. Сегодня поговорим о ревью и комментариях. Приведу реальные примеры из личного опыта, а также поделюсь наблюдениями, как процесс ревью повлиял на мое сознание.

Читать далее
Total votes 22: ↑19 and ↓3+21
Comments7

Составляем документацию разработчика пошагово без диет и тренировок

Reading time8 min
Views18K

Недостаточно просто написать инструкции — важно, как, в каком порядке и где вы их разместите. 

Привет! Это Теодора — технический писатель Платформы, жизненно важного департамента Ozon. Документация для нас имеет большое значение, потому что вся компания пользуется нашими разработками: инфраструктурой as a service; фреймворками и библиотеками; инструментами для работы с базами данных и аналитикой и прочим. Сотни инженеров ежедневно обращаются к нашим сервисам и нуждаются в их описании.

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

Читать далее
Total votes 47: ↑45 and ↓2+51
Comments6

Как я чуть не лишился должности после весёлого переезда компании в новый офис и организовал микросотовую систему

Reading time13 min
Views17K

Привет, Хабр! Меня зовут Александр. На первый взгляд, я типичный инженер в малоизвестной аутсорсинговой организации по обслуживанию IT-инфраструктуры компаний. Управляю небольшим отделом техподдержки и веду переговоры с заказчиками. У нас самая обыкновенная фирма: три филиала в разных городах, два программиста, отдел техподдержки. Помимо обслуживания компьютерных систем, мы занимаемся внедрением IP-телефонии и её интеграцией с CRM-системами.

У меня есть вроде как обычная хабраистория. Когда-то я работал руководителем IT-подразделения в автосалоне и невольно стал участником переезда компании в новый офис. На новом месте мне удалось внедрить такую схему, что сотрудник мог с одной DECT-трубкой перемещаться по всей территории предприятия (площадью более 3000 кв. м) и оставаться на связи. И я этой обыкновенной хабраисторией хотел бы поделиться.

Однако есть и во мне, и в моём проекте нечто такое, что на Хабре очень не любят. Один недостаток, который превращает всё в... Впрочем, мой каминаут будет под катом.

Читать далее
Total votes 49: ↑23 and ↓26+13
Comments27

От дропшиппинга до собственного пункта выдачи. Масштабируем IP-телефонию малого бизнеса

Reading time6 min
Views4.4K

Привет, Хабр! Меня зовут Дмитрий, я работаю в бюджетной организации в IT-отделе. Занимаюсь в основном телефонией и сетями.

В прошлом году мне посчастливилось принять участие в запуске успешного стартапа.
Двое ребят, Антон и Владимир, запустили интернет-магазин. И за 10 месяцев выросли от дропшиппинга до собственного пункта выдачи. А это аренда новых площадей и расширение штата сотрудников. Я выступал в роли подрядчика: помог ребятам с нуля настроить IP-телефонию, а затем её масштабировать, сэкономив при этом на оборудовании. Подробности под катом.

Читать далее
Total votes 4: ↑3 and ↓1+6
Comments6

Мои machine learning тулы для инвестирования

Reading time17 min
Views35K

В последнее время все больше людей приходит к тому, чтобы не держать деньги под матрасом, а куда-то их инвестировать в надежде сохранить и преумножить свой капитал. Вариант с матрасом плох тем, что с повышением цен на товары и услуги(инфляция) покупательная способность денег падает и через какое-то время купить на них можно значительно меньше, чем раньше. Есть много вариантов, куда вложить деньги(недвижимость, банковский вклад, ценные металлы), но в последнее время популярным становится инвестирование в акции. Только у брокера Тинькофф Инвестиции за несколько лет число клиентов превысило 3.5 млн. В статье я постараюсь описать свой подход к выбору бумаг и поделюсь инструментами, которые для этого разрабатываю.

Читать далее
Total votes 42: ↑41 and ↓1+53
Comments39

Как подружить монетизацию сайта с AdBlock. Кейс Habr.com и Roxot

Reading time5 min
Views9.7K

В 2020 году инструменты блокировки рекламы стоили издателям во всём мире $75 миллиардов упущенной выручки. В России цифры скромнее, но в среднем 25–30% россиян блокирует рекламу на ПК и мобильных устройствах. А значит, издатели могут терять треть дохода с рекламы.

Читать далее
Total votes 29: ↑19 and ↓10+29
Comments32

Полная домашняя автоматизация в новостройке

Reading time8 min
Views220K
Три года назад стал претворять свою давнюю мечту в реальность — максимальная домашняя автоматизация квартиры, купленной в новостройке с нуля. При этом «отделку от застройщика» пришлось принести в жертву умному дому image и полностью переделать, а вся электрика, не связанная с автоматикой приехала с известного китайского сайта. Паяльник не потребовался, но знающих мастеров, электриков и плотников пришлось искать долго.


Панель управления квартирой в феврале 2020 года (Home Assistant)

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


Строительство нашего дома в процессе — ноябрь 2016 года
Умный дом в самом соку...
Total votes 104: ↑101 and ↓3+132
Comments514

Information

Rating
Does not participate
Location
Красноярск, Красноярский край, Россия
Date of birth
Registered
Activity

Specialization

Content Writer, Technical Writer
Senior
Technical documentation
Interview
Linux
System administration
Network technologies
Telecommunications
API interfaces
Database
Dita
Markdown