[Moscow.pm] Доки

[Dmitry Arsentiev]

У меня вот нету подчинённых, но я убеждаю окружающих в том,
что надо писать документацию, почти исключительно личным примером.

Ну потом мотивация ещё важна.
Если некий програмист владеет недокументированным кодом,
то он царь и бог и сковырнуть его трудно.
Этому надо противостоять как-то.

На управленческом уровне решение вижу таким.

1) Парная разработка (в духе XP)

    либо

2) Вася разрабатывает неделю модуль А,
    Петя эту же неделю разрабатывает модуль Б.
    Причём перед началом разработки они пишут на вики,
    что же они хотят, чтобы эти модули делали.
    Постановку задачи, так скажем.
    Во время написания кода - код документируют pod-ом.
    А через неделю меняются местами: Вася => Б, Петя => А.
    Сперва наступают плач и скрежет зубовный, а за ними - катарсис и очищение.
    Помню, Бесков-Доронин (в своём ЖЖ кажется)
    похожую методу пропагандировал: смена ролей в команде.


28 ноября 2008 г. 17:20 пользователь Andrew Shitov <andy на shitov.ru> написал:
> Как вы заставляете коллег (подчиненных) писать документацию?
>
> Сегодня же написать минимальную документацию очень просто: есть вики,
> есть поды, есть что угодно. Не хотят, суки :-)
>
> --
> Andrew Shitov
> ______________________________________________________________________
> andy на shitov.ru | http://shitov.ru
> --
> Moscow.pm mailing list
> moscow-pm на pm.org | http://moscow.pm.org
>