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
150
Александр Мачулин (Gramax) – Справочник фантастических тварей из Docs as Code
Ozon Tech
December 12, 2023
Tweet
Share
More Decks by Ozon Tech
See All by Ozon Tech
Анастасия Писнова, «Текст как проект»
ozontech
0
10
Светлана Каюшина, Автоматизируем документирование и внедряем ИИ
ozontech
0
14
Павел Костромитин, «Что случилось у UXW T-Банка в 2024 »
ozontech
0
16
Сергей Горшенин, «Конвертация данных Ozon»
ozontech
0
25
Юрий Гуреев, «Интеграция 1С с внешними системами. Проблемы и их решения»
ozontech
0
45
Артём Нургалиев, «Кэш на кэш: как ускоряли автобиддеры»
ozontech
0
21
Анна Мария Попова (Х5 Tech) – Фантастический техпис: может ли опыт создания художественных книг помочь в написании документации
ozontech
0
190
Мария Смирнова – Дзен и искусство работы с документацией: как использовать принципы буддизма в работе техписа
ozontech
0
120
Сергей Кузнецов – «Эксперименты с нейросетями в рекомендациях»
ozontech
0
120
Other Decks in Technology
See All in Technology
君はPostScriptなウィンドウシステム 「NeWS」をご存知か?/sunnews
koyhoge
0
720
2.5Dモデルのすべて
yu4u
2
610
偶然 × 行動で人生の可能性を広げよう / Serendipity × Action: Discover Your Possibilities
ar_tama
1
740
飲食店予約台帳を支えるインタラクティブ UI 設計と実装
siropaca
6
1.4k
技術負債の「予兆検知」と「状況異変」のススメ / Technology Dept
i35_267
1
1k
Moved to https://speakerdeck.com/toshihue/presales-engineer-career-bridging-tech-biz-ja
toshihue
2
550
FastConnect の冗長性
ocise
1
9.6k
家電アプリ共通PF "Linova" のAPI利用とPostman活用事例ご紹介
yukiogawa
0
130
これからSREになる人と、これからもSREをやっていく人へ
masayoshi
6
4.1k
10分で紹介するAmazon Bedrock利用時のセキュリティ対策 / 10-minutes introduction to security measures when using Amazon Bedrock
hideakiaoyagi
0
170
SCSAから学ぶセキュリティ管理
masakamayama
0
140
WAF に頼りすぎない AWS WAF 運用術 meguro sec #1
izzii
0
460
Featured
See All Featured
Gamification - CAS2011
davidbonilla
80
5.1k
The Straight Up "How To Draw Better" Workshop
denniskardys
232
140k
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
marcduiker
27
1.9k
Producing Creativity
orderedlist
PRO
343
39k
4 Signs Your Business is Dying
shpigford
182
22k
Scaling GitHub
holman
459
140k
KATA
mclloyd
29
14k
GraphQLの誤解/rethinking-graphql
sonatard
68
10k
Visualizing Your Data: Incorporating Mongo into Loggly Infrastructure
mongodb
44
9.4k
Put a Button on it: Removing Barriers to Going Fast.
kastner
60
3.7k
The Language of Interfaces
destraynor
156
24k
Being A Developer After 40
akosma
89
590k
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