Как стать автором
Обновить
8
0
Игорь Р. Шахбазян @shahbazyan

Пользователь

Отправить сообщение

Как мы автоматизировали процесс генерации Release Notes

Время на прочтение9 мин
Количество просмотров13K

Всем привет! Меня зовут Семен. Я Java-разработчик и руководитель группы Java-разработки в Центре Big Data компании MTS Digital. В этом посте я хочу поговорить о Release Notes. Что это такое, почему не стоит писать их вручную и какие есть способы автоматизации. Покажу и реальный пример того, как организована  работа с Release Notes в нашем проекте.

Читать далее
Всего голосов 15: ↑14 и ↓1+13
Комментарии9

Удачный шаблон документации на API, который будут читать

Уровень сложностиПростой
Время на прочтение4 мин
Количество просмотров54K

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

Вы бы стали читать рецепт из 10 страниц, чтобы приготовить салат? Что-то я сомневаюсь. Схожая ситуация бывает в документации, когда она пишется без шаблона по принципу "чем больше, тем лучше".

Если ваши  документы не читают, не понимают, или вы не знаете с чего начать описывать интеграцию,  то эта статья для вас.

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

Читать далее
Всего голосов 4: ↑4 и ↓0+4
Комментарии11

Новый взгляд на документирование API и SDK в Яндексе. Лекция на Гипербатоне

Время на прочтение19 мин
Количество просмотров6.9K
Меня зовут Андрей Поляков, я руководитель группы документирования API и SDK в Яндексе. Сегодня я хотел бы поделиться с вами докладом, который я и моя коллега, старший разработчик документации Юлия Пивоварова, прочитали несколько недель назад на шестом Гипербатоне.


Светлана Каюшина, руководитель отдела документирования и локализации:
— Объемы программного кода в мире в последние годы сильно выросли, продолжают расти, и это влияет на работу технических писателей, которым приходит все больше задач на разработку программной документации и документирования кода. Мы не могли обойти стороной эту тему, посвятили ей целую секцию. Это три взаимосвязанных доклада, посвященных унификации разработки программной документации. Я приглашаю наших специалистов по документированию программных интерфейсов и библиотек Андрея Полякова и Юлию Пивоварову. Передаю им слово.
Всего голосов 21: ↑20 и ↓1+19
Комментарии0

Большая подборка открытых API

Уровень сложностиПростой
Время на прочтение2 мин
Количество просмотров27K

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

Читать далее
Всего голосов 18: ↑14 и ↓4+10
Комментарии3

Почему американские корпорации загоняют людей в офис. Личный опыт

Уровень сложностиПростой
Время на прочтение4 мин
Количество просмотров87K

В последние полгода появилась четкая тенденция: крупные корпорации загоняют сотрудников обратно в офис. Они обязуют 60% рабочего времени проводить в офисе, что примерно равно трем дням в неделю.

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

Сам работаю программистом в Амазоне уже больше двух лет. Начинал в команде в Ванкувере, Канада. Мне не понравилось и я переехал в Испанию, поменяв команду.

Читать далее
Всего голосов 194: ↑167 и ↓27+140
Комментарии292

Как и зачем работать медленнее? Метод Сергея Королёва

Время на прочтение15 мин
Количество просмотров94K


Будущий «отец» советской космонавтики Сергей Королёв — по центру. Страсть к авиации у него зародилась в юности, когда он записался в планерный кружок. На его долю ещё выпадут тяжёлые испытания, но юношеский запал у него останется на всю жизнь.

«Можно сделать быстро, но плохо, а можно — медленно, но хорошо. Через некоторое время все забудут, что было быстро, но будут помнить, что было плохо. И наоборот.»
Сергей Королёв, конструктор

К этим словам можно было бы больше ничего не добавлять. Но после прочтения этой цитаты могут остаться вопросы, и у нас тут, в конце концов, не сборник «цитат успешных людей», поэтому я всё же осмелюсь продолжить. Ведь кто из нас не стоял когда-то перед дилеммой между принесением немедленных результатов и обеспечением высокого качества работы? Что ж, Сергей Королёв, одна из ключевых фигур в истории освоения человеком космоса, мог бы многое вам поведать.

Читать дальше →
Всего голосов 151: ↑145 и ↓6+139
Комментарии133

Как изучать SQL в 2023 году

Уровень сложностиПростой
Время на прочтение7 мин
Количество просмотров95K

В 2023 году SQL (Structured Query Language) остается одним из самых популярных языков программирования, используемых в области баз данных и аналитики данных. Изучение SQL может быть полезным как для тех, кто только начинает свой путь в IT, так и для опытных профессионалов, которые хотят расширить свои знания и навыки. В этой статье мы рассмотрим несколько советов и ресурсов, которые помогут вам изучать SQL в 2023 году, и оставаться в курсе последних тенденций и изменений в этой области.

Согласно данным сайта Indeed.com, в 2023 году требования к кандидатам в вакансиях, связанных с базами данных и анализом данных, включают знание SQL в качестве обязательного навыка. Некоторые из таких популярных вакансий включают в себя SQL Developer, Data Analyst, Database Administrator, Business Intelligence Analyst и другие. Согласно данным сайта Glassdoor, зарплата специалистов, владеющих навыками работы с SQL, может составлять от $50 000 до $100 000 в год в зависимости от региона и уровня опыта. В связи с этим, изучение SQL может быть полезным для тех, кто хочет улучшить свои шансы на рынке труда и получать высокую заработную плату в IT-сфере.

Читать далее
Всего голосов 42: ↑37 и ↓5+32
Комментарии57

Docs as Code для художественной литературы. Делаем творческий сайт ребенка с помощью MkDocs

Уровень сложностиПростой
Время на прочтение13 мин
Количество просмотров7.4K


Docs as Сode — подход к работе с текстами, подразумевающий написание текста как кода:


  • в простом текстовом редакторе или IDE;
  • с использованием системы контроля версий;
  • с CI / CD / Code Review.

В настоящее время Docs as Code широко применяется при работе с технической документацией, давая техническим писателям и проектным командам массу удобств и преимуществ.


Но что если пойти дальше, попробовать такой подход не с техническими, а с художественными текстами? Что если автор — не технарь и не айтишник? Просто юный начинающий писатель, который пробует писать прозу и стихи ручкой на бумаге, и надеется познакомить широкую публику со своим творчеством?


В этой статье я расскажу о таком эксперименте (забегая вперед, удачном). Моей дочери 11 лет, она пишет сказки, стихи и рассказы. Чтобы поддержать ее увлечение, я помог ей создать литературный сайт, используя подход Docs as Code. Она успешно освоила основы Markdown и Git. Сейчас она самостоятельно публикует новые произведения и обновляет новости на своем сайте https://lib-beliakova.github.io/.

Читать дальше →
Всего голосов 44: ↑44 и ↓0+44
Комментарии17

Пользовательская документация в пайплайне разработки, или как мы делаем лучший портал поддержки софта для ритейла

Время на прочтение10 мин
Количество просмотров2.9K

Всем привет.

Меня зовут Саша, я технический писатель в CSI, но занимаюсь и проектами в нашей команде разработки. Считайте, что сегодня вы зашли ко мне на работу, плюхнулись в пуфики, взяли кофе — и я просто так рассказываю вам про наш портальчик. Всю публичную техническую документацию по ИТ-продуктам компании мы ведем на портале поддержки, который развернут в инстансе Atlassian Confluence Cloud. Расскажу, как мы к этому пришли, как работали над структурой и принципами подготовки материалов, какой от этого профит.

Картинка тут не случайно. Буквально вчера знакомый художник прислал мне такой портрет меня — и я подумал, что она тут в тему: думаю, многим знакома ситуация, когда в одной голове или ресурсе сосредоточены все знания. Это про меня. Но сейчас я с вами с удовольствием поделюсь!

История портала поддержки CSI
Всего голосов 8: ↑8 и ↓0+8
Комментарии6

Scratch — это уже не игрушки

Время на прочтение4 мин
Количество просмотров42K
Незаметно для нас Scratch из языка программирования для детей превратился в огромное онлайн-сообщество самоучек-программистов. За время пандемии количество пользователей этого языка удвоилось, и он начинает обгонять в рейтингах популярности «реальные» языки программирования (наподобие Typescript и Rust).

Scratch — это уже не игрушки.

Скорее всего, вы знаете, что Scratch — это язык программирования для детей, в котором используются визуальные блоки:


Как и многие родители в пандемию, я недавно познакомил с ним моих детей. Он постепенно начал их захватывать, и я осознал, что под его поверхностью скрывается нечто большее. Я решил присмотреться, и вот что обнаружил.
Читать дальше →
Всего голосов 55: ↑54 и ↓1+53
Комментарии99

Как проводить one-to-one встречи

Время на прочтение3 мин
Количество просмотров79K

Сегодня хочу поговорить о том, как проводить one-to-one встречи. 

Сначала о том, зачем они вообще нужны. One-to-one встречи – это один из инструментов развития команды. На этих встречах вы постепенно, планомерное выстраиваете отношения с сотрудником. Прозрачные, ясные отношения, в которых становится возможным сотруднику развиваться. В итоге эти встречи работают на адаптацию сотрудников, на их мотивацию и удержание. 

На встрече важно обсудить не только задачи. Вот примерная схема проведения one-to-one встречи.

 1. О сотруднике. С этого стоит начать. Спросите, как у него дела, что у него в жизни происходит.  

 2. Задачи. Какие сейчас у него задачи, какие у них сроки, какие есть проблемы. 

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

 4. Компания. Тут вы возвращаете сотрудника к тому, что он часть компании, что он приверженец определённой группы. Поделитесь с ним новостями компании и спросите, как это ему, поделитесь информацией про команду и тоже спросите, как это ему. Таким образом вы закрепляете за человеком его вовлечённость. 

 5. Работа с тимлидом. Самый неудобный вопрос) Можно задавать в лоб: «Как тебе работается со мной?» или окольными путями: «Что бы ты хотел в нашем взаимодействии улучшить, как тебе one-to-one, что бы ты хотел вынести на one-to-one», и т.д.

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

На одном из потоков курса «PSYvIT для управленцев» меня спросили, надо ли на каждой встрече говорить про компанию. Разве может отношение к компании меняться раз в неделю? Нет, не обязательно каждый раз, но раз в 2-3 недели спросите. Вопросы могут меняться: держите в фокусе компанию, а спросите про продукт, про новый релиз. Компания – это вообще про окружение сотрудника, про команду. Опять же, многое зависит от того, что в вашей компании происходит сейчас. Кроме вопросов, рассказывайте об успехах и изменениях, которые происходят. Очень важно, чтобы новости компании сотрудники узнавали от вас, а не из новостной ленты социальных сетей.

Читать далее
Всего голосов 28: ↑14 и ↓140
Комментарии24

Как тимлиду достоверно знать срок выполнения задач, не отвлекая подчиненных

Время на прочтение10 мин
Количество просмотров11K

Тимлиду постоянно приходится отвечать на вопрос «когда сделаете?» или «когда будет готово?». И часто для ответа на этот вопрос нужно отвлечь от работы своего сотрудника, обсудить с ним задачу и только после этого дать ответ.

Не факт, что ответ совпадет с реальностью. И любой руководитель знает, что для того, чтобы гарантированно уложиться в названый срок, нужно заложить минимум трехкратный запас времени. Заказчики этот принцип тоже знают и поэтому стремятся срезать срок, насколько это возможно. Тимлиду опять приходится отвлекать сотрудника и обсуждать с ним «варианты оптимизации сроков выполнения». Потом цикл повторяется до тех пор, пока кто-то — либо заказчик, либо тимлид — не упрется рогом, не продавит свое решение.

Недовольными, как правило, оказываются все. Тем не менее все постоянно играют в эту игру, и никто никому не верит.

Однако, если использовать исторические данные по сделанным ранее проектам и задачам, то можно узнать с 80% вероятностью срок исполнения задачи любого типа. Никакой магии. Просто математика и немного теории вероятностей :)) В этом суть Канбан-метода.

Читать далее
Всего голосов 31: ↑23 и ↓8+15
Комментарии26

Адаптационный чек-лист как инструмент мягкого введения в должность

Время на прочтение14 мин
Количество просмотров69K
Новый сотрудник в компании это стресс как для новичка, так и для компании. Для него все вокруг незнакомое: офис, продукт, команда, технологический стек, процессы. Ко всему этому нужно адаптироваться и разобраться побыстрее так, чтобы не замучить окружающих.

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



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

Настроить систему поможет адаптационный чек-лист. Он содержит в себе ключевые аспекты адаптации на разных этапах введения в должность: зоны адаптации, какие навыки и в какой последовательности должен изучить новичок, система наставничества, аттестация и обратная связь. Подробнее о том, что такое чек-лист и как он работает, расскажет Алексей Петров (pifagor_mc).
Всего голосов 37: ↑36 и ↓1+35
Комментарии14

Троллинг в рекламе техкомпаний

Время на прочтение5 мин
Количество просмотров15K

Троллинг неизбежен в современном мире соцсетей. Чем больше у вас аккаунтов в разных социальных сетях, чем больше у вас подписчиков и чем больше вы активны в Интернете, тем более велика вероятность, что вы станете целью троллинга. Чем больше у вас социальный капитал, тем больше будет желающих спровоцировать вас на реакцию, в основном на негативную — вызвать у вас чувство стыда, гнева, страха или оскорбления. Бывает нецелевой троллинг, когда вы можете стать жертвой того, кто «упражняется» в постиронии или попросту ему нечего делать. Если вы стали целью нежелательного вам троллинга, то запомните одно правило — полностью игнорируйте, не кормите тролля, не поддавайтесь на провокацию и никак не реагируйте!

Ну а в бизнесе все приемы хороши, и троллинг нашел применение в рекламе. Компании не упускают шанса кинуть камень в огород конкурента в своих рекламных акциях. Coca-Cola и Pepsi, Adidas и Puma, BMW и Audi, Mc'Donalds и Burger King откровенно стебутся над слоганами и дизайнами продукта друг друга. И конкуренты никогда в долгу не остаются, что приводит к цепной реакции и череде троллинга, которые не утихают издавна. Игнорирование подобных ходов визави вредит репутации, что оборачивается потерей прибыли. Ведь такая реклама не только задевает имидж, но и вызывает интерес к конфликту у потребителей. Рассмотрим удачные, ну или не очень, попытки троллинга в рекламе, которым не брезгуют и техкомпании. Но тут тоже важно запомнить правило: чтобы троллинг был удачным, он должен быть смешным для потребителя.
Всего голосов 43: ↑40 и ↓3+37
Комментарии11

Базы, карты, чек-листы, или Зачем бизнесу управляющий знаниями

Время на прочтение8 мин
Количество просмотров3.9K
Гарри Клейн — американский психолог, исследователь интуитивных решений в экстремальных ситуациях. В своей книге «Источники силы» Клейн описал один случай: пожарная команда приехала вызов, в жилом доме горела кухня. Команда вошла в помещение и начала тушить огонь, но он не затухал. В какой-то момент командир почувствовал тревогу и приказал срочно уходить. Когда все вышли из дома, пол на кухне провалился. Оказалось, что пожар начался в подвале, а потом перекинулся наверх, поэтому погасить его на кухне не удавалось.



Позже Гарри Клейн опрашивал командира, чтобы собрать материал для книги и ему удалось разобрать его интуитивное решение на части: огонь на кухне был слабым, но при этом слишком много жара и дыма для такого пламени. Командир почувствовал, что ситуация опасная и вывел команду. Это пример «неявного знания», которое спрятано так глубоко, что оно проявляется только в реальной ситуации.

Вытягивать «неявные знания», которые особенно помогают в экстренных ситуациях — одна из задач менеджера по управлению знаниями. Например, упал продакшн, серверы отказываются работать, но никто не знает почему. При этом полгода назад случалось что-то подобное и проблему решил Петя: «подшаманил», подкрутил и все заработало. Правда, Петя ушел в другую компанию, а ретроспективу не проводили, в базу знаний происшествие и решение не добавляли, потому что и базы-то никакой нет. Но если бы в команде был управляющий знаниями, возможно, последствий было бы меньше, а проблема бы решилась быстрее.
Читать дальше →
Всего голосов 16: ↑14 и ↓2+12
Комментарии0

Разведение мемов в корпоративных условиях: над чем смеются разработчики Dodo IS

Время на прочтение7 мин
Количество просмотров11K
Привет, Хабр! Недавно я подумала, что «хочу смеяться пять минут» и стала вспоминать рабочие приколы. Чем больше я смеялась, тем больше понимала, что сущность мемов сложнее, чем кажется. В итоге я написала эту статью, ставшую целым околонаучным изысканием. Под катом немного теории и самые закостенелые мемы Dodo Pizza Engineering.


Читать дальше →
Всего голосов 43: ↑35 и ↓8+27
Комментарии15

Ретропоезд с паровозом

Время на прочтение7 мин
Количество просмотров51K


Пока вы тут сидите, РЖД отлично продаёт билеты на ретропоезда. Это которые, натурально, с паровозом. Да, паровозы переживут многое, включая ядерную войну. Да, на нашем стратегическом резерве можно проехаться.



Итак, у нас ретропоезд «Рускеальский экспресс», который ходит по Карелии от города Сортавалы до горного парка Рускеала. Это 5 часов от Петербурга на важную туристическую точку.

А ещё кроме ретропоезда с нами поехали ретропассажиры. Точнее, студенты театрального колледжа, которые ставили иммерсивную постановку про коммунистов, перевозящих золото партии. Чем вынесли мозг немалому количеству пенсионеров.
Читать дальше →
Всего голосов 206: ↑198 и ↓8+190
Комментарии70

Хранение фотографий на DVD-дисках в 2K19-м (в 2190-м? в 2238-м?)

Время на прочтение7 мин
Количество просмотров53K

Первая цифровая фотокамера у меня появилась 14 лет назад. Тогда же возникла и проблема хранения фотографий. К счастью, в то время она решалась быстро и однозначно — записать на диск, и точка. Внешние HDD, да и внутренние тоже, тогда стоили дорого. SSD-дисков, по-моему, вообще не было, а если и были, то наверняка они стоили еще на порядок дороже. Хранить отснятое прямо на картах памяти и покупать каждый раз новую карточку — расточительное безумие. В общем, в домашних условиях какой-то разумной альтернативы DVD-дискам просто не существовало. К тому же, на дисках выходило множество игр, и DVD-привод в обязательном порядке присутствовал в компьютере. У меня был сразу пишущий дисковод.

В какой-то момент, а это было года 2-3 назад, я пришел к другу с записанным на DVD-RW-диск для него автосимулятором и обнаружил, что в его новом компьютере вообще отсутствует устройство для чтения дисков. Я был немного шокирован. Друг посмеялся: прийти с диском — это все равно, что приехать на автогонки на лошади с телегой. И тогда я понял, что эпоха CD-DVD уходит. Пришлось потом для переноса данных купить себе большую флэшку.
Читать дальше →
Всего голосов 100: ↑88 и ↓12+76
Комментарии641

Принципы документирования и локализации, или как получить хорошую локализацию минимальными затратами

Время на прочтение14 мин
Количество просмотров4.1K
Всем привет!

Меня зовут Денисов Александр. Я работаю в компании Naumen и отвечаю за документирование и локализацию программного продукта Naumen Contact Center (NCC).

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

image
Читать дальше →
Всего голосов 10: ↑9 и ↓1+8
Комментарии2

Медвежьи услуги по требованию

Время на прочтение9 мин
Количество просмотров30K
Можно не читать весь текст — в конце есть краткое содержание. Это я о вас забочусь, потому что я — хороший.

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

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

Как-то давно я работал ИТ-директором, и меня заставили написать то ли положение об отделе, то ли стратегию – не помню, как называлась эта бумажка. Проверяли ее лютые бюрократы, но одну фразу они пропустили, и в ней содержалась квинтэссенция этой штуки.

Звучало примерно так. Если Заказчик услуг ИТ-отдела хочет совершить ошибку, то ИТ-отдел ему об этом скажет. Если Заказчик настаивает на совершении ошибки, то ИТ-отдел с радостью ему в этом поможет.
Читать дальше →
Всего голосов 127: ↑103 и ↓24+79
Комментарии79

Информация

В рейтинге
Не участвует
Откуда
Санкт-Петербург, Санкт-Петербург и область, Россия
Дата рождения
Зарегистрирован
Активность

Специализация

Technical Writer
Lead