Водене на документация към проект, Водите ли си документация?

Здравейте колеги!
Имам следното питане към хората с повече опит и знания:
Водите ли си документация към проектите?
Как точно го правите?
Какво съдържат протоколите?
От къде се научихте?
Общо взето, всичко което посочите като ресурс от където да се научи нещо повече за методологиите, начините, добрите практики, скритите капани и т.н. при воденето на документация ще е наистина безценно ако го споделите.

По принцип повечето фирми у нас, които са аутсорсинг водят нулева документация на ниво модули.

Архитекта (независимо дали е у нас или в чужбина) си има негова документация от високо ниво, която обикновено е достъпна за всички други.

Но за функционирането на модулите на ниско ниво, обикновено никой не си играе да документира, или ако някой го направи, смятай че след година във фирменото вики ще четеш "стари новини".

Многократно съм повдигал този въпрос (във фирми с по 50+ човека) и най често отговора от мениджмънта е - чети кода.

Бих ти препоръчал Joel Spolsky - functional level documentation като нещо което е практично.

Много яко.

На същите тези мениджъри, когато те попитат нещо, веднага трябва да им казваш: "Не ме занимавай с глупости - чети кода!".


Това мнение е било редактирано от tol на 31-05-2013, 15:11

Наистина е трудно и времеемко да се води документация, но понякога без нея не може. Не е необходимо да си детайлен, а е важно да е достатъчна документацията. При нас решихме проблема със софтуер за управление на IT проекти, към който може да прикачаш и файлове. Софтуера има и безплатна версия до 10 юзъра. Казва се Gemini ( http://www.countersoft.com )

Това мнение е било редактирано от zen на 31-05-2013, 17:37