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) – Справочник фантаст...
Search
Ozon Tech
December 12, 2023
Technology
0
200
Александр Мачулин (Gramax) – Справочник фантастических тварей из Docs as Code
Ozon Tech
December 12, 2023
Tweet
Share
More Decks by Ozon Tech
See All by Ozon Tech
Анастасия Писнова, «Текст как проект»
ozontech
0
25
Светлана Каюшина, Автоматизируем документирование и внедряем ИИ
ozontech
0
28
Павел Костромитин, «Что случилось у UXW T-Банка в 2024 »
ozontech
0
38
Сергей Горшенин, «Конвертация данных Ozon»
ozontech
0
35
Юрий Гуреев, «Интеграция 1С с внешними системами. Проблемы и их решения»
ozontech
0
62
Артём Нургалиев, «Кэш на кэш: как ускоряли автобиддеры»
ozontech
0
26
Анна Мария Попова (Х5 Tech) – Фантастический техпис: может ли опыт создания художественных книг помочь в написании документации
ozontech
0
210
Мария Смирнова – Дзен и искусство работы с документацией: как использовать принципы буддизма в работе техписа
ozontech
0
130
Сергей Кузнецов – «Эксперименты с нейросетями в рекомендациях»
ozontech
0
130
Other Decks in Technology
See All in Technology
Data Hubグループ 紹介資料
sansan33
PRO
0
1.7k
VueUseから学ぶ実践TypeScript #TSKaigi #TSKaigi2025
bengo4com
3
5.3k
Oracle Database オプティマイザ・ヒントの活用
oracle4engineer
PRO
1
130
CloudTrailも、GuardDutyも、VPC Flow logsも… ログ多すぎ問題の整理術
nikuyoshi
5
570
AIオンボーディングとAIプロセスマイニング
nrryuya
5
1k
Postman AI エージェントビルダー最新情報
nagix
0
120
Oracle Base Database Service 技術詳細
oracle4engineer
PRO
8
65k
Introduction to Sansan, inc / Sansan Global Development Center, Inc.
sansan33
PRO
0
2.6k
AIコードエディタは開発を変えるか?Cursorをチームに導入して1ヶ月経った本音
ota1022
1
540
AIエージェントデザインパターンの選び方
almondo_event
0
110
それでもぼくらは貢献をつづけるのだ(たぶん) @FOSS4GLT会#002
furukawayasuto
1
240
新卒から4年間、20年もののWebサービスと向き合って学んだソフトウェア考古学 - PHPカンファレンス新潟2025 / new graduate 4year software archeology
oguri
2
310
Featured
See All Featured
The World Runs on Bad Software
bkeepers
PRO
68
11k
How GitHub (no longer) Works
holman
314
140k
Fireside Chat
paigeccino
37
3.5k
Rebuilding a faster, lazier Slack
samanthasiow
81
9k
Statistics for Hackers
jakevdp
799
220k
Dealing with People You Can't Stand - Big Design 2015
cassininazir
367
26k
The Myth of the Modular Monolith - Day 2 Keynote - Rails World 2024
eileencodes
25
2.8k
RailsConf 2023
tenderlove
30
1.1k
Become a Pro
speakerdeck
PRO
28
5.3k
A Tale of Four Properties
chriscoyier
159
23k
Making Projects Easy
brettharned
116
6.2k
Learning to Love Humans: Emotional Interface Design
aarron
273
40k
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