Internet Info, s.r.o. Lupa Měšec Podnikatel Root Zdroják DigiZone Slunečnice Vitalia Tuesday TopDrive KupDnes Navrcholu Bomba NovýTarif Dobrý web Weblogy Woko Jagg Computer.cz SK: MojeLinky

Hlavní navigace

Názor ke zprávičce Jak napsat dokumentaci k projektu během pár minut?

Franta Kučera aura:80
7. 7. 2009 18:46

Hodnotné informace

celé vlákno

Vždyť nejvíc práce je stejně s tím, aby člověk vyjádřil hodnotné informace, které má jinak jen v hlavě a zpřístupnil je ostatním formou dokumentace. A s tím ti žádný program nepomůže. Vygenerovat se dají kvanta textu, ale s jakou hodnotou? Tu hodnotu tam musí dát člověk (do komentářů, zvláštních značek atd.)

Ty nástroje samozřejmě smysl mají, používám JavaDoc a Doxygen, ale bohužel řeší jen formátování/tran­sformaci a ne tu fázi, která je pro hodně programátorů „největší vopruz“ :-D tzn. přepis informací z vlastní hlavy někam jinam :-)