Идея писать документацию - хороша :) Но из опыта скажу - серьёзная документация требует организационного решения: - кто и когда должен писать какие разделы, - как его этому обучить и на это мотивировать, - кто и когда будет контролировать соответствие написанной документации реальности. Описания этого решения в тексте явно не хватает :)
Хороший комментарий! Мы решили эту проблему так: - собрали команду из людей, которые больше всего заинтересованы в расширении внутренней инфраструктуры - мы работаем как студия, поэтому для нас внутренние улучшения устроены как проект на заказ. Я выступаю в роли заказчика, а команда вместе с ПМом в роли исполнителей
Идея писать документацию - хороша :)
Но из опыта скажу - серьёзная документация требует организационного решения:
- кто и когда должен писать какие разделы,
- как его этому обучить и на это мотивировать,
- кто и когда будет контролировать соответствие написанной документации реальности.
Описания этого решения в тексте явно не хватает :)
Хороший комментарий! Мы решили эту проблему так:
- собрали команду из людей, которые больше всего заинтересованы в расширении внутренней инфраструктуры
- мы работаем как студия, поэтому для нас внутренние улучшения устроены как проект на заказ. Я выступаю в роли заказчика, а команда вместе с ПМом в роли исполнителей