Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
Александр Мачулин (Gramax) – Справочник фантастических тварей из Docs as Code
Search
Ozon Tech
December 12, 2023
Technology
0
26
Александр Мачулин (Gramax) – Справочник фантастических тварей из Docs as Code
Ozon Tech
December 12, 2023
Tweet
Share
More Decks by Ozon Tech
See All by Ozon Tech
Анна Мария Попова (Х5 Tech) – Фантастический техпис: может ли опыт создания художественных книг помочь в написании документации
ozontech
0
120
Мария Смирнова – Дзен и искусство работы с документацией: как использовать принципы буддизма в работе техписа
ozontech
0
25
Сергей Кузнецов – «Эксперименты с нейросетями в рекомендациях»
ozontech
0
54
Артём Нургалиев – «MLOps, автоматизированное обучение и доставка моделей»
ozontech
0
36
Артём Панин – «Автоматическое управление рекламой в Ozon»
ozontech
0
56
Дмитрий Андросов – «Персональные поисковые подсказки»
ozontech
0
69
Константин Ожерельев – CI/CD для проектов, разрабатываемых в конфигураторе
ozontech
0
72
Юрий Гуреев – 5 продвинутых приемов работы с EDT и Git
ozontech
0
63
Евгений Мазуренко – Как управлять проектами и не терять связь с заказчиком
ozontech
0
44
Other Decks in Technology
See All in Technology
アクセシビリティを考慮したUI/CSSフレームワーク・ライブラリ選定
yajihum
2
1k
家族アルバム みてねにおけるGrafana活用術 / Grafana Meetup Japan Vol.1 LT
isaoshimizu
1
780
アクセス制御にまつわる改善 / Improving access control
itkq
0
550
AOAI をきっかけに 社内の Azure 管理を見直した話
recruitengineers
PRO
1
320
Google Cloud の AI を支える裏側のインフラを垣間見る!
maroon1st
0
360
私が trocco を推す理由
__allllllllez__
1
260
Reducing Cross-Zone Egress at Spotify with Custom gRPC Load Balancing Recap
koh_naga
0
210
Cloud Native Java with Spring Boot (CNCF Aarhus, April 2024)
thomasvitale
1
180
Vertex AI を中心に 生成AIのアップデートを共有します
kaz1437
0
310
[新卒向け研修資料] テスト文字列に「うんこ」と入れるな(2024年版)
infiniteloop_inc
4
16k
開発生産性大幅アップ!Postman VS Code拡張機能
nagix
2
390
Janus
bkuhlmann
1
490
Featured
See All Featured
Gamification - CAS2011
davidbonilla
76
4.6k
Building a Scalable Design System with Sketch
lauravandoore
456
32k
Visualizing Your Data: Incorporating Mongo into Loggly Infrastructure
mongodb
34
8.9k
WebSockets: Embracing the real-time Web
robhawkes
59
7k
個人開発の失敗を避けるイケてる考え方 / tips for indie hackers
panda_program
60
14k
No one is an island. Learnings from fostering a developers community.
thoeni
16
2.1k
Debugging Ruby Performance
tmm1
70
11k
The Cost Of JavaScript in 2023
addyosmani
16
3.9k
Understanding Cognitive Biases in Performance Measurement
bluesmoon
7
1k
How to train your dragon (web standard)
notwaldorf
73
5.2k
Why You Should Never Use an ORM
jnunemaker
PRO
51
8.6k
Why Our Code Smells
bkeepers
PRO
331
56k
Transcript
Docs as Code, проблемы, решение Gramax Александр Мачулин Techdoc Meetup
По позициям: • Бизнес-аналитик. • Проектный менеджер, владелец продукта. •
Директор по продуктам и проектам. По навыкам: • Писал ТЗ и документацию на системы. • Работал с SQL, Python, VB. • Писал код в проектах. Обо мне
Пишу ТЗ Что пишем: • Технические задания. • Документацию на
систему. Кто пишет: • Бизнес-аналитик. • Проектный менеджер. Что по инструментам: • DOCX на Sharepoint. • Dropbox.Paper. • И в веб-интерфейсе систем. 2020 год
Технический директор предложил
• Удобное ревью благодаря Git-транзакциям. • Создание веток и их
объединение. • CI/CD. • Статические сайты. • Асинхронное редактирование. Почему Docs as Code — это хорошо
None
None
None
Инструменты: • Язык разметки и редактор. • Markdown-превью. • Расширения
для Markdown. • Git. • Git-хранилище. • Static site generator. • Диаграммы.
None
None
None
None
None
Не гуглить, а идти в ChatGPT.
None
None
Как снизить вред: • Обсуждать документацию только в таск-трекере. •
Подключить плагин к static site generator.
None
None
Как снизить вред: • Сделать инструкцию, ориентированную только на работу
в GitLab. • Принимать в команду только с опытом. • Общий аккаунт ChatGPT.
Что имеем в итоге: • Зоопарк инструментов и систем. •
Сложное ежедневное использование. • Согласование с заказчиком вне плоскости Docs as Code. • Продолжительный поиск людей или онбординг.
None
None
Что сделали: • Объединили нужные инструменты в одно приложение. •
Вынесли ключевые сценарии использования в простой интерфейс. • Добавили инлайн-комментарии в редактор. • Сделали ссылку на ревью в браузере.
None
None
None
@Alexvnder