В идеальной вики я бы видел ИИ, который привязан к гит с кодом проекта. Я использую подобное для пет проекта и это отлично позволяет составлять документацию: тебе по сути ничего делать не надо, просто даешь ему шаблоны и он заполняет, какие изменения нужно делать. Жаль для рабочей документации так делать нельзя 🥲
Конечно, нужно валидировать, но все же это гораздо быстрее (порой недели могут сократиться до часов). Осталось только его BPMN-диаграммы рисовать, с Mermaid-диаграммами он и так отлично справляется)
Так что ИИ полезен не только для чтения документации, но и для ее написания. Но опять-таки, все нужно валидировать, а если на странице вся задача написана, то ИИ в целом может и не понадобиться
У меня недостаточно кармы, чтобы минусовать, да я и не собирался)
Согласен, что подобная возможность круто смотрится. Но только с MCP, потому что если просто в отрыве от контекста отправить тзшку, то можно накодить неправильно. Хотя в большинстве своем справится
У нас на работе, к сожалению, нет встроенного в wiki ИИ. Все обещают сделать что-то свое, но пока никак. MCP для wiki подключить, конечно же, никто не даст, потому что правила безопасности не позволяют. Можно пользоваться гптшками, но не сильно погружая ее в контекст (нельзя всю базу кодовую слить)
Мне тоже в статье про ведение документации начали писать, что уметь грамотно ее вести не так важно, если сейчас все делает ИИ. На самом деле, если правильно все сделать, то ИИ и не нужен будет.
В целом, я описал частично в своей статье, но чтобы вам не пришлось лезть, кратко объясню: я организую всю документацию на разных страницах-артефактах в вики, так как таким образом это не превращается в длинное полотно на 30-100 страниц, в этом легче ориентироваться и гораздо легче поддерживать. И да, каждая задача для разработчика — это отдельная страница. Ему вообще с нее не нужно уходить: там все описано, что нужно для конкретной задачи, а ссылки на другие страницы — дополнительная информация, если вдруг разработчик решит почитать, но это не обязательно для выполнения задачи.
У меня была проблема в первом ТЗ для разработчиков на этом месте работы, что ко мне приходили с вопросами "А это как делать?". Но чаще всего эти вопросы решались тем, что я указывал на какой-то абзац на той же странице задачи. Нет, задача не написана на 10 страниц, там максимум набирается страницы 2, но обычно — меньше страницы. Вся документация строго структурирована и никакой воды в ней нет: только инструкции, что сделать. Был момент, когда ко мне бэкендерша пришла с вопросом, на который был ответ буквально в следующем абзаце. Она просто не дочитала.
После работы со мной в рамках первого требования, разработчики все поняли и больше с такими вопросами не приходят)
Пользовался как раз в антигравити Клодом и гемини. Клод реже выдавал ошибки. Конечно, я не прогер, чтобы прям качество кода проверять, но вроде пишет чисто. По крайней мере с гемини 3 про у меня чаще валилась прога, в то время как Клод понимал даже самые простые промпты в одну строку
Используй comss.dns, он бесплатный. С Gemini не работает, но со всеми остальными гптшками, в том числе с Клодом, работает.
Клода на Pro плане мне хватало недельных лимитов на дня 3-4. На Max плане я в принципе не дохожу до них, хотя прогаю больше, а стоит это 100 долларов. Ну и конечно он откатывается быстро. При этом Sonnet считается по лимитам отдельно от Opus. Обычных лимитов мне тоже хватает, редко выхожу за них, но они откатываются за 1-2 часа.
Gemini Pro мне не понравился, чаще чем Opus ложает. Также можно попробовать Antigravity, можно купить акк Gemini Pro на полгода тысячи за полторы с доступным антигравити. Там лимиты как на Pro версии у Клода, но в целом сойдёт
Чем курсор хорош? Я купил базовую подписку за 20 баксов и она улетела за три часа. Я думал, она как в клоде, лимит восстановится через какое-то время, но он на каждое действие списывал положенные на него деньги и подписка, по сути, закончилась. Может я делал что-то не так, но кажется, что это максимально жадная контора просто
Как замечательно, что вы избавились от всех проблем на текущей работе: все примеры с плохими решениями были исключительно на предыдущих местах работы!
Вы рассказали, как определить, что техдолг есть. Вы сказали, как его найти. Вы упомянули, как им управлять. Но как его решать? Проблема техдолга же не в том, что он есть, а в том, что его некогда делать. Бизнес приходит постоянно с требованиями и как всегда все нужно было сделать вчера, где найти место техдолгу? Вы хорошую мысль затронули, что непонятно, какую бизнес-ценность принесет решение технического долга. Так как ее определить?
Развернуть можно, но как говорится, а зачем?) Задача для разработчика описывается в одной конкретной статье, которая самодостаточна, не требует обязательных переходов на другие статьи. Да, можно пойти за доп информацией, но вся основная информация тут — на этой странице. Тут нейронка избыточна. А декомпозиция еще проблему поддержки решает: когда меняется одно требование, я вижу, на какие оно влияет. На сплошной странице — это поиск по тексту.
ИИ может помогать, конечно, и вообще хорошо его иметь встроенным в саму вики: вот тогда он будет максимально полезным, так как будет брать контекст не только по задаче, но и по системе в целом.
В идеальной вики я бы видел ИИ, который привязан к гит с кодом проекта. Я использую подобное для пет проекта и это отлично позволяет составлять документацию: тебе по сути ничего делать не надо, просто даешь ему шаблоны и он заполняет, какие изменения нужно делать. Жаль для рабочей документации так делать нельзя 🥲
Конечно, нужно валидировать, но все же это гораздо быстрее (порой недели могут сократиться до часов). Осталось только его BPMN-диаграммы рисовать, с Mermaid-диаграммами он и так отлично справляется)
Так что ИИ полезен не только для чтения документации, но и для ее написания. Но опять-таки, все нужно валидировать, а если на странице вся задача написана, то ИИ в целом может и не понадобиться
Знаю, что это просто. Но не все компании готовы идти на такое. Не знаю еще по вопросу СБ: у нас в целом вики доступна только под впн.
На прошлом месте работы мы вели работу в docmost и у нас джуны писали к нему mcp, так что я понимаю, что работа не пыльная)
У меня недостаточно кармы, чтобы минусовать, да я и не собирался)
Согласен, что подобная возможность круто смотрится. Но только с MCP, потому что если просто в отрыве от контекста отправить тзшку, то можно накодить неправильно. Хотя в большинстве своем справится
У нас на работе, к сожалению, нет встроенного в wiki ИИ. Все обещают сделать что-то свое, но пока никак. MCP для wiki подключить, конечно же, никто не даст, потому что правила безопасности не позволяют. Можно пользоваться гптшками, но не сильно погружая ее в контекст (нельзя всю базу кодовую слить)
Многое в СБ упирается
Вообще считаю, что каждая вики должна иметь возможность вставить видео с сабвей серферс справа от статьи, чтобы удерживать внимание разработчиков)
Мне тоже в статье про ведение документации начали писать, что уметь грамотно ее вести не так важно, если сейчас все делает ИИ. На самом деле, если правильно все сделать, то ИИ и не нужен будет.
В целом, я описал частично в своей статье, но чтобы вам не пришлось лезть, кратко объясню: я организую всю документацию на разных страницах-артефактах в вики, так как таким образом это не превращается в длинное полотно на 30-100 страниц, в этом легче ориентироваться и гораздо легче поддерживать. И да, каждая задача для разработчика — это отдельная страница. Ему вообще с нее не нужно уходить: там все описано, что нужно для конкретной задачи, а ссылки на другие страницы — дополнительная информация, если вдруг разработчик решит почитать, но это не обязательно для выполнения задачи.
У меня была проблема в первом ТЗ для разработчиков на этом месте работы, что ко мне приходили с вопросами "А это как делать?". Но чаще всего эти вопросы решались тем, что я указывал на какой-то абзац на той же странице задачи. Нет, задача не написана на 10 страниц, там максимум набирается страницы 2, но обычно — меньше страницы. Вся документация строго структурирована и никакой воды в ней нет: только инструкции, что сделать. Был момент, когда ко мне бэкендерша пришла с вопросом, на который был ответ буквально в следующем абзаце. Она просто не дочитала.
После работы со мной в рамках первого требования, разработчики все поняли и больше с такими вопросами не приходят)
Спасибо за ответ!
Пользовался как раз в антигравити Клодом и гемини. Клод реже выдавал ошибки. Конечно, я не прогер, чтобы прям качество кода проверять, но вроде пишет чисто. По крайней мере с гемини 3 про у меня чаще валилась прога, в то время как Клод понимал даже самые простые промпты в одну строку
Используй comss.dns, он бесплатный. С Gemini не работает, но со всеми остальными гптшками, в том числе с Клодом, работает.
Клода на Pro плане мне хватало недельных лимитов на дня 3-4. На Max плане я в принципе не дохожу до них, хотя прогаю больше, а стоит это 100 долларов. Ну и конечно он откатывается быстро. При этом Sonnet считается по лимитам отдельно от Opus. Обычных лимитов мне тоже хватает, редко выхожу за них, но они откатываются за 1-2 часа.
Gemini Pro мне не понравился, чаще чем Opus ложает. Также можно попробовать Antigravity, можно купить акк Gemini Pro на полгода тысячи за полторы с доступным антигравити. Там лимиты как на Pro версии у Клода, но в целом сойдёт
Поставить лайк не могу, кармы не хватает(
Спасибо за статью. Тоже было интересно, куда идти за рубежом когда такой профессии точь-точь нет. Было интересно почитать
Поздравляем! Партия вами довольна! Вы получаете повышение: держите своя кошка-жена и миска риса!
Чем курсор хорош? Я купил базовую подписку за 20 баксов и она улетела за три часа. Я думал, она как в клоде, лимит восстановится через какое-то время, но он на каждое действие списывал положенные на него деньги и подписка, по сути, закончилась. Может я делал что-то не так, но кажется, что это максимально жадная контора просто
Типичная ситуация с журналюгами. Как говорил мой дядя: "На одном конце города пернешь, на другом скажут, что обосрался". Пример во всей красе
Что-то мне кажется мы тут не о личных задачах говорим...
Как замечательно, что вы избавились от всех проблем на текущей работе: все примеры с плохими решениями были исключительно на предыдущих местах работы!
Вы рассказали, как определить, что техдолг есть. Вы сказали, как его найти. Вы упомянули, как им управлять. Но как его решать? Проблема техдолга же не в том, что он есть, а в том, что его некогда делать. Бизнес приходит постоянно с требованиями и как всегда все нужно было сделать вчера, где найти место техдолгу? Вы хорошую мысль затронули, что непонятно, какую бизнес-ценность принесет решение технического долга. Так как ее определить?
Развернуть можно, но как говорится, а зачем?) Задача для разработчика описывается в одной конкретной статье, которая самодостаточна, не требует обязательных переходов на другие статьи. Да, можно пойти за доп информацией, но вся основная информация тут — на этой странице. Тут нейронка избыточна. А декомпозиция еще проблему поддержки решает: когда меняется одно требование, я вижу, на какие оно влияет. На сплошной странице — это поиск по тексту.
ИИ может помогать, конечно, и вообще хорошо его иметь встроенным в саму вики: вот тогда он будет максимально полезным, так как будет брать контекст не только по задаче, но и по системе в целом.
Нейронка есть не в каждой компании, а по безопасности сторонними сервисами может быть запрещено пользоваться, как у меня на работе
Мы получается жопой слушали
Перечитал и понял после этих слов
Поддерживаю, я тоже не понял) Тут как раз проблема говорения ртом