DocOps – Telegram
DocOps
4.52K subscribers
43 photos
1 file
384 links
Writing about work, Developer Relations and Developer Experience, mentorshiop, conferences, documentation, and everything that I work and live with.

Author: @nick_volynkin

Mentorship: https://getmentor.dev/mentor/nikolay-volynkin-186
Download Telegram
Ещё CodeFest X.

Тем временем, моя коллега из Плеска Надя Мануйлова закинула пуллреквест с ещё 4 конспектами CodeFest:

Додо в LeSS: как не заблудиться
Основные ошибки при проведении экспериментов
Moneyball. Как построить команду продактов, когда на рынке их нет
Сколько нужно энергии для работы Scrum Master, Product Owner и Agile Coach?

И там ещё конспекты добавятся. А потом будет второй, секретный этап. Я вам про него позже расскажу. А пока что спасибо Наде!
Непрерывная локализация.

Слышали про принцип «сдвига влево» (shift left)? Непрерывная локализация (continuous localization) реализует этот принцип для перевода документации, интерфейса и других текстов.

Раньше было так: сначала разработка, потом пишем тексты, потом их переводим и наконец можем выпустить релиз. А теперь мы пишем тексты на этапе проектирования, а робот забирает их и отдаёт переводчикам. А готовые переводы сам коммитит обратно в ветку разработки. Тексты и переводы перестают блокировать релиз, и это уменьшает time to market всего продукта. Угадайте, как это влияет на прибыль и риски компании?

Техписатели из Xsolla рассказали на Хабре, как у них выстроен процесс непрерывной локализации. Они там переводят 20 проектов на 20 языков, сроки сжатые, всё автоматизировано. Xsolla крутые, спасибо им за статьи.

— 20 проектов, 20 языков, срок вчера
20 проектов, 20 языков, срок вчера. Часть 2
Что делать, если ваш код на Python тормозит.

Если вы загрустили от прошлого доклада про сравнение Python и Go, срочно примите противоядие. Григорий Бакунов из Яндекса рассказывает, как ускорить работу Python с помощью трёх подходов:
— разумно оптимизировать код,
— использовать другой интерпретатор: PyPy или Cython,
— переписать критичные куски на другом языке, прямо в коде на Python.

https://github.com/docops-hq/conf/blob/master/moscowpython/19/accelerate-python.md
​​Рефакторинг: договариваемся, планируем, внедряем!

Как вы уже поняли, астрологи объявили неделю конспектов. Теперь снова с Кодфеста. Алексей Катаев рассказывает про рефакторинг: как продать руководству, как организовать, где лежат грабли.

Спасибо Эмилю Янгирову за пуллреквест!

https://github.com/plesk/codefest19/blob/master/source/skyeng-refactoring.md
Представьте, что в вашем проекте есть линтеры, проверка типов, юнит- и интеграционные тесты, property-based тесты и даже тесты на документацию. И стопроцентное покрытие во всех смыслах. И все тесты проходят.

Всё ли хорошо?
Anonymous Poll
17%
Да, похоже что всё хорошо.
83%
Нет, тесты же могут не работать.
Мутационное тестирование.

А вы хороши, большинство не верит тестам слепо и безоговорочно. Действительно, в тестах бывают баги, так что их тоже надо тестировать. Никита Соболев рассказал на #MoscowPythonConf2019 о том, как готовить мутационное тестирование и писать реально работающие тесты.

Держите конспект: https://github.com/docops-hq/conf/blob/master/moscowpython/19/kill-mutants.md

Вот сделаю мутацеонные тесты на документацыю — тоже расскажу об этом. 🙂
​​Конфиги nginx на JavaScript.

Идея писать конфиги nginx на тьюринг-полном языке программирования не нова. Но тут сами разработчики nginx сделали такой модуль. Уже можно писать код на JS и байндиться к нему из конфига с помощью специальных директив. А скоро (обещают в 2019) станет можно и прямо в конфиге nginx писать нa JS.

Про это рассказал на #SaintHighLoad2019 Дмитрий Волынцев из nginx. Держите конспект: https://github.com/docops-hq/conf/blob/master/highload/19/spb/njs-nginx.md

А ещё они, конечно, перепробовали все интерпретаторы JS и сделали свой, супербыстрый. Посмотрите на бенчмарки:
DocOps pinned «​​Программа KnowledgeConf готова! Программа конференции по управлению знаниями KnowledgeConf готова. Мы выбрали 24 лучших доклада из 83 заявок. Прямо сейчас докладчики активно работают над своими докладами, а мы будем вам о них рассказывать. Лана Новикова…»
​​UDP против TCP, или Будущее сетевого стека.

Александр Тоболь из Одноклассников рассказывает на #SaintHighLoad2019, почему в мире беспроводных сетей ненадёжный UDP может быть надёжнее, чем надёжный TCP. Конечно, не чистый UDP, а реализованный поверх него собственный протокол: self-made UDP. Александр отлично объясняет всё, что нужно понимать, если вы работаете с доставкой контента.

Информации в докладе много, очень много. Я конспектировал его два с половиной часа и ещё не дошёл до конца. Трансляция позволяет перемотать непонятный фрагмент и послушать его ещё раз. И потом ещё раз. Что это вам напоминает? Мне — TCP. Мой мозг умеет принимать информацию примерно втрое медленнее, чем Александр умеет её отправлять. Да, а если бы я сидел в зале, был бы UDP. 🙂

Вот первая часть конспекта: https://github.com/docops-hq/conf/blob/master/highload/19/spb/tcp-vs-udp.md

А ниже график того, что происходило в моей голове, когда я слушал доклад. У кого так же?
27 отборных докладов и мастер-классов про управление знаниями в IT.
Forwarded from Knowledge Conf Channel
Смотрите, в какое плотное расписание мы упаковали все доклады KnowledgeConf. Три потока по восемь докладов и один трек под специальные форматы – имеет смысл наметить маршрут по конференции заранее.
https://knowledgeconf.ru/2019/schedule.html
Forwarded from Knowledge Conf Channel
Мы обещали вам подробно рассказать о том, что еще будет на KnowledgeConf кроме докладов, и держим слово. А будет интересное — будем экспериментировать и мечтать. И обязательно посмотрите на идеи из непринятых докладов и напишите в комментариях, что нужно обсудить в будущем.
https://habr.com/ru/company/oleg-bunin/blog/445040/
Читатели, как вы знаете, чуть менее, чем через неделю состоится KnowledgeConf - первая профессиональная конференция по управлению знаниями в IT компаниях. На ней собрали интересные кейсы, дискуссии и спикеров из таких компаний, как Badoo, Skyeng, Google, КРОК, Lamoda, Миран, Skillbox, Стратоплан, Тинькофф, БИОКАД, Ozon и еще десятка уважаемых компаний.

У вас есть отличная возможность буквально на флажке выиграть билет на нашу конференцию и другие подарки 🔥🔥🔥.

1. До 23:59 по Москве 23 апреля разместите пост в любимой соцсети или канале в Телеграмме о том, какую практику в управлении знаниями вам удалось применить или чем, как вам кажется, вашей компании было бы полезно управление знаниями (тема на выбор).
2. Добавляете хэштег #knowledgeconf2019 ВАЖНО! Ваш профиль должен быть открыт на время проведения флешмоба, чтобы мы могли найти ваш пост по хэштегу.
3. 23 апреля в 23:59 мы случайным образом разыграем билет на конференцию и утешительные призы - три любимые книги, рекомендованные членами Программного комитета конференции. Книги мы передадим лично или отправим почтой в любой город.
4. Каждый участник конкурса получит скидку на билет в размере 10 процентов.

Участвуйте! Конференция обещает быть очень крутой. Кстати, подписанным на этот канал быть не обязательно, так что репостите информацию.
10 компетенций и 6 ролей Knowledge Manager

Сегодня на #knowledgeconf2019 модерирую зал Кембридж и пишу конспекты. Потому что могу!

Первый доклад — от Марии Мариничевой, о том как найти и обучить собственного менеджера знаний.

https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/knowledge-manger-6-10.md
Применение практик Тиаго Форте для управления своими знаниями.

Огненный доклад на #knowledgeconf2019 от Андрея Александрова про то, как читать книги и статьи like a boss и наполнять собственную базу знаний.

Конспект: https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/tiago-forte-practices.md
Добро пожаловать на борт: вводим в строй новых разработчиков

Глеб Декайло рассказал на #knowledgeconf2019 про то, как в Badoo вводят в команду новых сотрудников.

За конспект спасибо Екатерине Носковой! https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/badoo-new-developers-onboarding.md
How to Create Compelling Multimedia Documentation.

Alexandra White из Google рассказывает, как сделать документацию в форме видео и вебинаров. А ещё — когда её делать не нужно.
Конспект: https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/multimedia-documentation.md

#knowledgeconf2019
Как я 15 лет делал себе персональную Wiki для программиста

Григорий Петров придумал себе язык разметки для собственной вики-системы и пишет в нём заметки 15 лет. Я смотрел только предварительный прогон ещё в январе, и мне больше всего запомнилось вот что:

1. Я два года не писал на Ruby и ничего не помню
2. За два часа я перечитываю свой конспект по Ruby
3. Теперь я снова middle-разработчик на Ruby. PROFIT!

Спасибо Андрею Александрову (@aladmit_world) за конспект. https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/xi-notes-for-developer.md

---

Trello — эффективная система управления знаниями для небольшой IT-команды

Не думали, что так можно? Вот и я удивлён. Роман Хорин рассказывает, как Trello работает в качестве базы знаний для команды дизайнеров в Atman Digital. Особенно хорошо такая база знаний помогает вводить новичков в команду.
Конспект: https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/trello-kb.md

#knowledgeconf2019
Я не знаю, как документировать БД. Если вы знаете, пожалуйста, расскажите об этом в @docsascode.
Forwarded from Elena Baskakova
Привет! Поделитесь опытом, пожалуйста, как описывать все БД, если у тебя есть только IDE. С чего нужно начать, какие инструменты лучше использовать?
​​В документации Grav CMS уже прочитанные главы помечаются галочкой.

❤️