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
57
Дмитрий Андросов – «Персональные поисковые подсказки»
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
LayerXにおけるLLMプロダクト開発の今までとこれから
layerx
PRO
3
590
地理空間データ可視化・解析・活用ソリューション Pacific Spatial Solutions (PSS)
pacificspatialsolutions
0
330
One engineer company with Ruby on Rails
rstankov
2
410
生成AIの変革の時代に、直近1年で直面した課題とその解決策
ktc_wada
0
510
Cloud Service Mesh に触れ合う
phaya72
1
150
データベース02: データベースの概念
trycycle
0
180
Grafana x PagerDuty Better Together
jacopen
1
240
【基本】データベース設計
oracle4engineer
PRO
2
130
いいたいことちゃんという
tkengo
0
230
ExaDB-D dbaascli で出来ること
oracle4engineer
PRO
0
2.1k
チームでロジカルシンキングに改めて向き合っている話 〜学習環境と実践⽅法〜
sansantech
PRO
3
3.2k
AWS学習者向けにAzureの解説スライドを作成した話
handy
3
180
Featured
See All Featured
BBQ
matthewcrist
80
8.8k
Visualization
eitanlees
137
14k
Happy Clients
brianwarren
92
6.4k
The Brand Is Dead. Long Live the Brand.
mthomps
49
29k
How STYLIGHT went responsive
nonsquared
92
4.8k
Dealing with People You Can't Stand - Big Design 2015
cassininazir
358
22k
The Psychology of Web Performance [Beyond Tellerrand 2023]
tammyeverts
12
1.5k
A designer walks into a library…
pauljervisheath
201
23k
Rails Girls Zürich Keynote
gr2m
91
13k
Product Roadmaps are Hard
iamctodd
45
9.7k
Easily Structure & Communicate Ideas using Wireframe
afnizarnur
188
16k
Writing Fast Ruby
sferik
622
60k
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