но ведь его уже один раз подвинули

Я просто не люблю политику и футбол. Не хочу развивать в этом чате эти темы)

Давайте лучше по делу наброшу на вентилятор

Поделитесь опытом, у кого всё хорошо в проекте с документацией: где ведёте, какими ритуальными мероприятиями актуализируете, что фиксируете там?

у нас в репе в MD формате лежит, генерится через https://docsify.js.org/#/
пишем туда описание наших АПИ методов, описание нашей внутренней архитектуры, описание поставщиков - где смотреть их доку и тд тп

это если прям кратко 🙂

Интересно, спасибо

Где-то я уже это видел 🙂

я твой пост видел, но мы до этого начали этим генератором пользоваться 🙂 так что все законно 🙂

Ну, может, на брейнвошинге узнали)) а вы как запускаете сам «сервер» для документации? У вас он только локально или во внешнем мире тоже есть где-то?

🔥

нам девопсы на сервере разверули его,  с доступом по внутренней сети + CD настроен, что после коммитов в мастер сразу деплой туда идет

Недурственно

Всем привет!

Я тут набираю в команду (Senior) Backend Engineers
Локация - Берлин (временно удаленно, но с релокацией потом)

Наш стек:
- Rails 6
- Postgres, Redis, DynamoDB
- Sidekiq
- AWS
- и все такое

Из прикольного:
- Хороший менеджмент — CEO, CTO, лид(я) тоже ничего
- Интересные клиенты (Siemens и другие  большие производители, которых я не уверен могу ли называть)
- Попадаются интересные задачки :)
- Большая свобода в выборе подходов/архитектур
- Монолит, но постепенно разбивается на контексты (DDD)

По деньгам точной информации у меня нет, но ориентировочно ~60-75k

В общем рекомендую :)
Рад пообщаться и может поработать вместе.

https://careers.shyftplan.com/o/senior-backend-engineer-fmd

а есть примеры что и как там лежать может?

А можешь рассказать об этом на митапе в августе?)

Или на RubyRussia в онлайне в сентябре, туда CFP уже открыли

Не слишком ли короткая тема для конференции?) а рассказать, только если онлайн, а то я не из Питера)

Щас поищу, по плану, в произвольном порядке, как каталоги сделать, так и будут роуты

Мне кажется если рассмотреть вопрос «как это затащить в проект, чтобы быстро показать бизнесу пользу», тема может получиться не такой уж короткой

вот да

и по каким убеждениям нужно жить, как процессы подстраивать, чтобы оно не развалилось через месяц

Вообще про многие штуки было бы интересно вот так в динамике подкрепить опытом сопровождения уже имеющиеся материалы, выстроенные в статике условных паттернов «сделать один раз» или «затащить в проект»