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
220
Александр Мачулин (Gramax) – Справочник фантастических тварей из Docs as Code
Ozon Tech
December 12, 2023
Tweet
Share
More Decks by Ozon Tech
See All by Ozon Tech
Анастасия Писнова, «Текст как проект»
ozontech
0
30
Светлана Каюшина, Автоматизируем документирование и внедряем ИИ
ozontech
0
44
Павел Костромитин, «Что случилось у UXW T-Банка в 2024 »
ozontech
0
63
Сергей Горшенин, «Конвертация данных Ozon»
ozontech
0
44
Юрий Гуреев, «Интеграция 1С с внешними системами. Проблемы и их решения»
ozontech
0
76
Артём Нургалиев, «Кэш на кэш: как ускоряли автобиддеры»
ozontech
0
32
Анна Мария Попова (Х5 Tech) – Фантастический техпис: может ли опыт создания художественных книг помочь в написании документации
ozontech
0
220
Мария Смирнова – Дзен и искусство работы с документацией: как использовать принципы буддизма в работе техписа
ozontech
0
160
Сергей Кузнецов – «Эксперименты с нейросетями в рекомендациях»
ozontech
0
140
Other Decks in Technology
See All in Technology
事業価値と Engineering
recruitengineers
PRO
6
4.6k
実践アプリケーション設計 ②トランザクションスクリプトへの対応
recruitengineers
PRO
4
1k
『FailNet~やらかし共有SNS~』エレベーターピッチ
yokomachi
1
170
KINTO FACTORYから学ぶ生成AI活用戦略
kintotechdev
0
130
AIエージェント就活入門 - MCPが履歴書になる未来
eltociear
0
660
役割は変わっても、変わらないもの 〜スクラムマスターからEMへの転身で学んだ信頼構築の本質〜 / How to build trust
shinop
0
110
モダンな現場と従来型の組織——そこに生じる "不整合" を解消してこそチームがパフォーマンスを発揮できる / Team-oriented Organization Design 20250825
mtx2s
6
42k
Preferred Networks (PFN) とLLM Post-Training チームの紹介 / 第4回 関東Kaggler会 スポンサーセッション
pfn
PRO
1
280
JavaScript 研修
recruitengineers
PRO
5
1.2k
新規案件の立ち上げ専門チームから見たAI駆動開発の始め方
shuyakinjo
0
520
広島銀行におけるAWS活用の取り組みについて
masakimori
0
160
Grafana MCPサーバーによるAIエージェント経由でのGrafanaダッシュボード動的生成
hamadakoji
0
180
Featured
See All Featured
Six Lessons from altMBA
skipperchong
28
4k
[RailsConf 2023 Opening Keynote] The Magic of Rails
eileencodes
30
9.6k
Visualizing Your Data: Incorporating Mongo into Loggly Infrastructure
mongodb
48
9.7k
The Invisible Side of Design
smashingmag
301
51k
The Success of Rails: Ensuring Growth for the Next 100 Years
eileencodes
46
7.6k
Bash Introduction
62gerente
614
210k
Docker and Python
trallard
45
3.5k
The Cost Of JavaScript in 2023
addyosmani
53
8.9k
Automating Front-end Workflow
addyosmani
1370
200k
Mobile First: as difficult as doing things right
swwweet
224
9.9k
What’s in a name? Adding method to the madness
productmarketing
PRO
23
3.6k
Building a Scalable Design System with Sketch
lauravandoore
462
33k
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