Forum Debian Users Gang

Sytuacja wygląda tak że na naszym sofcie piszemy aplikacje, soft jest wewnętrznym narzędziem firmy, i aby cokolwiek dopisać do aplikacji tworzonej na nim (np. kontrolkę, czy tam jakąś klasę) trzeba wiedzieć co i jak z czym połączyć, co gdzie wrzucić i co za metody zaimplementować. A braków jest sporo i najczęściej wygląda to tak że chcąc coś zrobić musimy nieźle natruć tyłki programistom którzy to narzędzie tworzą, a oni często nie mają czasu, albo samemu nie wiedzą dokładnie co i jak (bo dawno robili, bo ten kto to robił już nie pracuje itd.). Wszystko to kończy się tym że nam motywacja do pisania czegoś własnego szybko "uchodzi", do tego spowalnia to rozwój całej platformy i wprowadza zamęt (już o takich rzeczach jak per update utrata części kompatybilności wstecznej nie wspominając).

Stąd pytałem kierownika programistów czy nie mogli by pisać dokumentacji na takim poziomie aby ktoś z zewnątrz się w to szybko wdrożył, na co usłyszałem że w kodzie (tak do kodu dostęp mamy, tyle że wdrażania się w niego bez dokumentacji to są miesiące jak nie lata, zakładając  że nie robi się nic innego) są komentarze i to im wystarcza, a poza komentarzami to oni sobie dekompilują i patrzą jak co działa, że dokumentacji na poziomie chociażby MSDN to oni pisać nie będą bo czasu nie mają itd. itp.

Od tamtej pory mnie nurtuje czy w innych firmach jest podobnie - w kilku książkach raczej doświadczonych programistów często idzie wyczytać że brak dobrej dokumentacji prędzej czy później wyjdzie i będzie odczuwalny przez wszystkich. Ba jakiś czas temu czytałem że takie coś potrafi "zarżnąć" dobrze prosperujące systemy, bo nawet ludzie którzy je tworzyli po kilku miesiącach będą mieli problem z połapaniem się co oni tam robili, co podnosi koszty, wydłuża czas i pogarsza jakość itd.

Nie wiem może mam jakieś kosmiczne wymagania, ale skoro w otwartych projektach kilka osób potrafi pisać całkiem niezłą dokumentację, to w firmie nie powinno być podobnie?

Ostatnio edytowany przez Huk (2012-04-14 20:57:44)

Ja bym szukał nowej pracy jakbym musiał grzebać w takim ... Szkoda czasu. Podał byś nazwę firmy na priva coby omijać ;]

u mnie tylko to co skomplikowane.