Ten tekst będzie o tym co warto dokumentować i jak to robić – oczywiście z bardzo subiektywnego punktu widzenia(!). No i o tym, że wcale nie zawsze potrzebujemy dokumentacji – a wręcz czasem najlepsze co możemy zrobić to skasować istniejące dokumenty! Ale po kolei. Zanim dotrzemy do rozwiązania, musimy najpierw spojrzeć na przyczyny i źródła zamieszania…
Co to znaczy, że projekt jest gotowy? W praktyce może oznaczać to bardzo różne rzeczy…
Pewnego dnia wezwał mnie mój kierownik i powiedział: „Jest taki nowo napisany system SmerfMaruda, tam wszystko jest już gotowe i wdrożone, brakuje tylko funkcjonalności MarudzeniaSpecjalnego. Dopisz tę funkcję, nie powinno ci to zająć więcej niż dwa dni”.
Ponieważ nie znałem tego systemu, przeszedłem się do kolegów, którzy go napisali. Po kilku rozmowach okazało się, że „system jest prawie gotowy”. A to małe słowo „prawie” oznaczało następujące kwestie:Czytaj dalej »Jest już prawie gotowe
Jesteśmy ludźmi – lubimy porządek, ale nie lubimy sami sprzątać. Dlatego też dobrze jest jeżeli niektóre rzeczy same dbają o porządek.
Codzienną czynnością programistów jest oddawanie (operacja commit) kodu do repozytorium kodu źródłowego. Przy tej operacji można wpisać komentarz opisujący jakie zmiany funkcjonalne są oddawane, np. „dodana możliwość usuwania kontrahentów” czy „poprawienie błędu przy definiowaniu nowej operacji”. Wszyscy wiedzą, że opisywanie tych zmian jest bardzo ważne – ale też bardzo często w repozytorium lądują zmiany bez żadnych opisów. A sprawdzenie listy zmienionych obiektów oraz zmian w ich w celu określenia co się zmieniło jest bardzo pracochłonne…
Co wtedy robimy?Czytaj dalej »Automatyczny strażnik commit’ów
Rzecz o estymacjach – czyli czym się różni prowadzenie projektu IT
od urządzania kuchni
Kiedyś wydawało mi się, że w pracy informatyka najtrudniejsze jest samo wykonanie pracy – to znaczy projektowanie lub implementowanie jakiejś nowej funkcjonalności. Myliłem się. Bo od wykonania samej pracy dużo trudniejsze jest wcześniejsze oszacowanie jej pracochłonności…Czytaj dalej »Szacowania, szacowania…