[SaintWykopek]

#programista15k

[hieronimgieroslawski]

@SaintWykopek tak było na początku prac nad cyberpunkiem, a tak starzy wyjadacze się żegnali jak badowskiemu zacząło odwalać #cyberpunk2077

[oslet]

@SaintWykopek i słusznie. Każdy chce niby tej dokumentacji ale przecież każdy i tak doskonale wie, że nawet jak się pojawi to jednorazowo, nie będzie aktualizowana, i mało kto ją przeczyta. Nie po to są nowoczesne środki porozumienia się żeby pisać do, siebie wielostronicowe listy jak w średniowieczu.

[kowalzmetina]

@SaintWykopek: dobry kod sam w sobie jest dokumentacją ( ͡º ͜ʖ͡º)

[mrcino]

@oslet: No to wyobraź sobie tłumaczenie tej samej konfiguracji 10 różnym osobom podczas gdy wystarczyło przeczytać te "listy".

Poza tym nie da się zapamiętać wszystkiego, po to jest dokumentacja.

Nie chciałbym z Tobą pracować xD
Każdy poważny inżynier zaczyna od zapoznania się z docsami i API...

[kamil062]

@SaintWykopek If it was hard to write, it should be hard to read ( ͡º ͜ʖ͡º)

[Euphor]

@oslet szczegolnie jest to nieprzydatne w przypadku architektury systemow, rodzaju zaleznosci miedzy elementami. Ale kto by sie tam przejmowal, hit commit i do domku xD

[GienekZFabrykiOkienek]

nawet jak się pojawi to jednorazowo, nie będzie aktualizowana, i mało kto ją przeczyta

@oslet: Jak nie będzie aktualizowana to nikt jej nie będzie czytał, wot odkrycie xD Krótka piłka - idzie commit, razem z kodem musi lecieć zmiana w dokumentacji.

[C.....i]

@oslet: dokumentacja powinna przede wszystkim dotyczyć stabilnych elementów takich jak architektura systemu czy opracowane procesy. Dzięki temu może służyć jako gwarancja stosowania przyjętych praktyk i utrzymania wizji projektu. Nie powinna tym samym zbyt często podlegać zmianom. Brak odpowiedniej dokumentacji promuje chaos w zespole i bałagan w produkcie.

[SiergiejLapczydow]

@SaintWykopek: I am THE documentation

[billybumbler]

@SaintWykopek: ja sem ten kto klepe

[Mimimimimimimimimimimi]

@kowalzmetina:
Proszę prosty przykład. Co zwraca funkcja f?
int f(int n) { return (n==1 || n==0) ? 1: n * f(n - 1); }

[kthxbye]

@Mimimimimimimimimimimi: wynik ( ͡° ͜ʖ ͡°)

[Jednorybek]

@Mimimimimimimimimimimi: było napisane "dobry kod" ogólnie #!$%@? że rekurencja, ale zmienne jedno literowe i takie same funkcje to nie jest dobry kod ( ͡° ͜ʖ ͡°)

[Mimimimimimimimimimimi]

@Jednorybek: nazwa funkcji by ją zdraziła. Jest to prosty jednolinijkowiec. Zagadka - co liczy.

[Jednorybek]

@Mimimimimimimimimimimi: silnia?

[temokkor]

@Mimimimimimimimimimimi funkcja zwraca silnie z n