TGViewer
Техниндзя Техниндзя @tekhpisovoe · 529 subscribers
Post #404 413

Forwarded from V{IT}A ZAEBYMBA | Путь корпората

ПИШИТЕ ДОКУМЕНТАЦИЮ! СРОЧНО!

Попалась мне вчера просто афигенная новость. И если уж она не убедит людей, которые терпеть не могут писать документацию, то уже, кажется, ничто не убедит🤣

Я даже знаю некоторых системных аналитиков, которые меня уверяли, что писать доку — это бестолковое занятие! А, да?🤣🤣 Пиз….

Новость особенно зайдет тем, кто играл в Ведьмака (да, это я, поэтому вдвойне орнула, когда это читала)

❔ Итак, смотрим:

Техписатели CD Projekt RED рассказали, как плохая документация осложнила разработку ремейка первой части «Ведьмака»

И почему студия решила полностью изменить подход к этому процессу

После проблем с разработкой Cyberpunk 2077 компания провела реорганизацию и одной из главных скрытых проблем оказалась внутренняя документация, которая в CDPR десятилетиями велась хаотично

Во времена оригинального «Ведьмака» студия была маленькой, поэтому сотрудники передавали знания устно — «за чашкой кофе», а не через базы данных

Из-за этого сегодня разработчикам ремейка приходится буквально восстанавливать старые технологии и решения по кусочкам. Даже бывшие сотрудники CDPR, которые помнят те времена, не могут заполнить все пробелы

Дополнительной ошибкой стало закрытие внутренней вики после выхода «Ведьмака 3: Дикая Охота». Компания решила сэкономить ресурсы и не перенесла данные в другое место, из-за чего часть важной информации была потеряна

Проблема особенно проявилась во время создания REDkit — инструментария для моддеров. Техписателям пришлось искать старые документы через архивы, закрытые серверы и даже случайно найденные скриншоты старой вики

Во время разработки Cyberpunk 2077 ситуация стала ещё сложнее: документация разрослась до 8 тысяч страниц, а ближе к релизу её поддержка снова потеряла приоритет

Дополнительный хаос вызвал перенос части базы данных в «облако», из-за чего информация оказалась разбросана между разными системами. Теперь CD Projekt изменила подход, поэтому для «Ведьмака 4» и Cyberpunk 2 студия ввела обязательные требования к документации

Сейчас каждый этап разработки считается завершённым только при наличии всей нужной информации. Также обе команды работают с единой базой знаний, чтобы свободно обмениваться технологиями и решениями между проектами


Ну что, как вам? Жизненно? 😆

Меняются поколения, появляются новые компании и специалисты, но человеческое "Я работаю на отъ€бись, как и все здесь" — бессмертно! Как и забивание на документирование собственных безумств, которые потом раскапывать другим🤣🤣

Даже такие крупные студии грешат, но и до них дошла вся плачевность ситуации, когда доки нет 💀

Это как до Яндекса недавно дошло, что на проектах всё-таки нужны системные аналитики, и их потихоньку начали нанимать

__________________________________

Что касается меня, то я документацию писать обожаю. Могу этим просто брать и обмазываться🤣

Меня это успокаивает. Во-первых, делаю реально полезное дело, которое потом помогает всем вникнуть в происходящее, а во-вторых, не приходится тонну инфы держать в голове, иначе кукукнуться можно
😱

Руководство приняло правильное решение, когда решили нанять Деву в качестве СА🤣🤣

Буквально вчера закончила объемную доку по критически важному треку во всей компании, отправила на предварительное ревью разрабам — разрабы получили оргазм
🫨

А все потому что неплохо так покопалась в коде, столько всего интересного узнала и зафиксировала.
Уже что-то и сами разрабы забыли, но теперь им вспоминать и не придется, потому что есть мои санскриты 😎 Я горжусь своей работой

Это к вопросу о том, надо ли системному аналитику понимать код. Но это уже другая тема для разговора, обсудим позже


А теперь давайте поболтаем…

🔘Как относитесь к написанию документации? Ведете её или нет?))

💪 — Да, обязательно / стараемся обновлять

🚬 — Нет, дока для слабаков

P.S. Ведьмаку 3 вчера исполнилось 11 лет


@vitazaebymba
  • 😁 7
  • 🍾 3
More from @tekhpisovoe
  1. Sep 7, 2026Неделю назад был День знаний, в который я, по иронии судьбы, получил самое настоящее новое…
  2. Aug 28, 2026Так, вы же не думали, что я остановлюсь на разборе UX разных блюд и ассоциаций техписатель…
  3. Aug 20, 2026Привет-привет! 👋 Сегодня расскажу историю про то, как когда-то я пытался понять «Дюну» и…
  4. Aug 6, 2026Привет-привет! 👋 Долго отсутствовал на канале, потому что случайно установил в «Госуслуга…
  5. Jul 13, 2026Несу вам анонс годного мероприятия. Команда RWB (объединенная компания Wildberries & Russ)…
  6. Jul 4, 2026Один из кэрролловских персонажей говорит Алисе, что чтобы только оставаться на месте, нужн…
Threads Profile ViewerView any public Threads profile without an account.Open ThreadLook →Writing with AI? Make it sound human.Metric37 rewrites AI drafts so they read naturally. Free AI detector, 1,500 words free.Try Metric37 →