[MrGalosh]

#humorobrazkowy #heheszki #humorinformatykow #programowanie #programista15k

[zegarmistrz001]

@MrGalosh: Nawet jak jest dokumentacja często okazuje się że nie była aktualizowana przez 2 lata i tak trzeba debugować.

[Saly]

@MrGalosh: 5 minutes of debugging can save you 6 hours of reading documentation

[Majonez33]

@MrGalosh: Czasami dokumentacja jest tak duża i rozproszona że lepiej zajrzeć do kodu. Chyba że sprawdza się logikę biznesową, wtedy jednak lepiej zajrzeć do dokumentacji.

[Saly]

Chyba że sprawdza się logikę biznesową, wtedy jednak lepiej zajrzeć do dokumentacji.

@Majonez33: kod ma jednak tą zaletę, że nie kłamie

[Krolik]

@Saly: I w ten sposób powstaje kolejny kod, który zamiast na dokumentacji, polega na błędach w kodzie napisanym wcześniej :P

[Saly]

@Krolik: albo na błędach napisanych w dokumentacji. Nie widzę różnicy

[j557]

@MrGalosh: still got paid ¯\_(ツ)_/¯

[Majonez33]

@Saly: Tylko jak wtedy sprawdzisz czy operacja jest zgodna z tym, co chce klient ( ͡° ͜ʖ ͡°)

[Saly]

@Majonez33: a kto mi gwarantuje, że dokumentacja jest zgodna z tym co chce klient?

[Krolik]

@Saly: Różnica jest w tym kogo należy potem winić za niedziałający produkt.

[Krolik]

a kto mi gwarantuje, że dokumentacja jest zgodna z tym co chce klient?

@Saly: nikt, ale wtedy to będzie problem klienta

Poza tym nie chodzi tylko o dokumentację od klienta.
Tu chodzi też o dokumentację np. używanych bibliotek czy API systemu.
Jeśli implementujesz swoje oprogramowanie pod konretne zachowanie systemu, a nie pod dokumentację, to możesz być niemal pewien, że to się posypie po którejś aktualizacji systemu / bibliotek. I będzie to

[Mopek666]

@MrGalosh: U nas się powtarza, że tydzień programowania potrafi zaoszczędzić pięć minut myślenia. ( ͡º ͜ʖ͡º)

[Saly]

Różnica jest w tym kogo należy potem winić za niedziałający produkt.

@Krolik: w większości przypadków dokumentację pisze ten sam deweloper/team co kod, więc co za różnica. Nawet jest https://www.hyrumslaw.com/

Jeśli implementujesz swoje oprogramowanie pod konretne zachowanie systemu, a nie pod dokumentację, to możesz być niemal pewien, że to się posypie po którejś aktualizacji systemu / bibliotek. I będzie to wtedy Twoja wina, a klient słusznie będzie reklamował.

@Krolik: ale ja

[d.....z]

a kto mi gwarantuje, że dokumentacja jest zgodna z tym co chce klient?

@Saly: może nie kto, ale oficjalny podpis/approve klienta pod dokumentem, który definitywnie i ostatecznie ustala wymagania i/lub informuje, co jest "źródłem prawdy" w projekcie (kod, dokumentacja, prezentacja, zeznania developera lub zespołu developerskiego, etc)? Wtedy jak klient wskaże źle, to będzie jego podpis pod tym i jego problem.

[Krolik]

w większości przypadków dokumentację pisze ten sam deweloper/team co kod, więc co za różnica. Nawet jest https://www.hyrumslaw.com/

@Saly: To nadal nie oznacza przecież że kod zawiera dokładnie to samo co dokumentacja.

Podam Ci przyklad. Dostałeś metodkę jakiegoś API, która zwraca listę identyfikatorów użytkowników. W dokumentacji napisane "zwraca listę identyfikatorów użytkowników, którzy coś tam...". Odpalasz tę metodę na testowym systemie i dostajesz [1000, 1001, 1002, 1005, 1034, 1035, 1040]. O fajnie, są

[p.....1]

@Saly: 1 hour of debugging can save you 20 minutes of reading documentation and 1 hour of debugging, because the documenation is worth shit ( ͡° ͜ʖ ͡°)

[FrasierCrane]

@MrGalosh: 5 minutes of debugging can save you 6 hours of reading documentation

@Saly: ctrl+f mówi to coś panu ( ͡° ͜ʖ ͡°)

[Saly]

@devopsiarz: mówiąc dokumentacja chodzi mi o is written text or illustration that accompanies computer software or is embedded in the source code. To o czym piszesz to bardziej specyfikacja albo kontrakt

[Diabl0]

I w ten sposób powstaje kolejny kod, który zamiast na dokumentacji, polega na błędach w kodzie napisanym wcześniej :P

@Krolik: Ale wtedy nikt nie przylatuje do ciebie że robiąc refaktoring #!$%@?ście, bo wcześniej działało to inaczej niż teraz.

Gdybym dostawał ziemniaka za każdym razem gdy widzę biznes który nie wie na jakich zasadach działa bo programiści którzy to pisali odeszli, to bym miał dziś więcej ziemniaków niż łukaszenka.

[Saly]

@Krolik: oczywiście się zgadzam. To o czym mówię to szukanie bibliotek na githubie jak porównujesz różne alternatywy i chcesz na szybkości ogarnąć co dany lib robi. Jak biblioteka nie ma ładnych przykładów albo benchmarków to po kodzie czasami idzie szybciej ogarnąć czy dany lib ma sens i co robi. Oczywiście warto potem przejrzeć dokumentację jak chcesz użyć kodu produkcyjnie.