[wodzik]

#heheszki #humorinformatykow #programowanie #programista15k

[kkrzysiek13]

@wodzik: Ja dostałem odpowiedź, "Code speaks for itself" xD. Imo main features powinny mieć jakieś notatki i wyjaśniena. Takie core punkty dla biznesu. Wiadomo, że szczegółowa dokumentacja nie ma sensu. Ale wszystko o co klient (zewn czy wewn) może zapytać powinno być w dokumentacji.

[c.....c]

bo skąd wiesz, czy Index nie przekaże tego FileHandle dalej i powinien być otwarty po tym jak Index zostanie zamknięty?

@Krolik: trochę niejasno piszesz, o ile Cię dobrze rozumiem to żeby tak się stało to musiałby przekazać do innego threada

[Krolik]

@taraqui: Chciałem Ci pokazać, że bardzo wielu istotnych własności kodu nie jesteś w stanie udokumentować samym kodem, a cała dyskusja jest o tym że "dobry kod sam się dokumentuje". Dobry kod dokumentuje się co najwyżej częściowo. Sygnatury metod nawet w Javie często są niewystarczające aby na ich podstawie stwierdzić jak poprawnie użyć kodu.

[t.....i]

@Krolik: w takim razie inputuję, że nie jesteś najlepszy w pokazywaniu

[Krolik]

@czwarta_gestosc: to Java, wystarczy że zapisze sobie w jakimś polu static. Nie musi przekazywać do innego threada. :D

[c.....c]

@Krolik: good point

[Krolik]

podałeś przykład klasy która została okraszona dokumentacją, teraz zabierasz dokumentację i pałujesz że hurr durr nie da się nic zrozumieć bez dokumentacji

@taraqui: niezupełnie, w Javie nie da się zdefiniować metody przyjmującej jakiś zasób (niech będzie FileHandle ale może być cokolwiek innego) tak aby *bez czytania dokumentacji* użytkownik wiedział jak jej bezpiecznie użyć. Po prostu w takim przypadku musisz mieć dokuementację, bo sam język nie jest wystarczająco ekspresywny.

[Krolik]

@taraqui: > w takim razie inputuję, że nie jesteś najlepszy w pokazywaniu

wykop nie jest najlepszy we wklejaniu kodu ლ(ಠ_ಠ ლ)

[fledgeling]

"the documentation" a nie "documentation" (╯︵╰,)

[dioxxx]

@wodzik: historia mojej firmy w jednym zdaniu xD

[m.....o]

@yggdrasil: co to jest SH?

[y.....l]

@maly_ludek_lego: Software House.

[G.....r]

@wodzik: mem smieszny wiele lat temu, obecnie dokumentowanie przed jest idiotyczne, dokumentujesz po implementacji (lub podczas np w kodzie).

[proszebardzo2]

ta, zdokumentuj se w kodzie architekturę

@Macwil: o infrastructure as code to pewnie nie słyszałeś.

[M.....l]

@proszebardzo2: mowimy o dwoch roznych rzeczach

[proszebardzo2]

@Macwil: wydaje ci się

[papaj42]

infrastructure as code

@proszebardzo2: co ma IaC do architektury aplikacji?

[kaitek666]

dobry kod sam się dokumentuje

@galencjusz: największa bzdura powtarzana przez wannabe programistów ( ͡° ͜ʖ ͡°)