Hvilket bud bryter du oftest?

[tickinghd]

Egoløs Programmering er et konsept hvor personlige faktorer minimeres for å øke kvaliteten på det som produseres. Er interessert i å se hva dere på forumet mener om hvilke av disse dere bryter oftest, eller ikke tenker på i hverdagen.

En veldig god liste det der. Det er i grunn ting man tror man "vet" men som man aldri har satt ord på.

 

Ser at flere har stemt på "..behandle folk som kan mindre enn deg med respekt, ærbødighet, og tålmodighet". Nå har jeg ikke opplevd så ofte at andre utviklere har brutt den regelen, men jeg har inntrykk av at de som er respektfull og tålmodig med andre oppnår mye respekt tilbake.

[rozon]

Kode som dokumentasjon kan kanskje være tyngre å lese enn kommentarer i en del tilfeller, i når man kommer dit at produksjonskode + unit-test ikke er tilstrekkelig, så er utfyllende kommentar nødvendig og riktig verktøy. Ikke før.

 

Du mener omvendt ja? Kommentarer kan være tyngre enn å lese koden... Kommentarer i koden skal kun brukes når det ikke er en bedre måte å forklare hva koden gjør. Noen få kommentarer er nyttige fortsatt, eksempelvis TODO med en forklaring og kanskje CAUTION med en forklaring.

 

XML dokumentasjon som i f.eks. C# er en annen ting. Det mener jeg er et must for alt som er public definert. Du kan ikke være sikker på at den som bruker koden din faktisk har tilgang til å lese koden, så da må man jo ha en form for dokumentasjon. Kommentarer og dokumentasjon er ikke det samme... Jeg ville bare nevne det...