Jeg blev for nylig medlem af en organisation, hvor jeg skal være en af de to nye leadudviklere på det offentlige websted. Den tidligere udvikler (som var alene) efterlod en betydelig codebase, som skønt den er funktionel, men er stiv og skrøbelig. Normalt siger ordsprog "hvis det ikke går i stykker, skal du ikke rette det", men i dette tilfælde gør den dårlige kodestil og manglende dokumentation koden ulæselig (for mig, den anden udvikler og vores praktikanter) og kræver derfor ekstra tid, når du tilføjer funktioner, justerer ting. Både min partner og jeg har fundet det vigtigt for både vores mentale velvære såvel som nødvendigt, hvis udviklingsholdene skal komme videre i organisationens tidsplan.
Problemet er, at vores chef, som også er organisationschef (biologi phD, ikke en udvikler) mener, at den sidste fyr var strålende, og mener ikke, at en omskrivning er nødvendig. Både min partner og jeg har forsøgt at kontakte den tidligere udvikler, men til ingen nytte - det ser ud til, at han er forsvundet ud af jordens overflade. Hvordan overbeviser jeg / vi chefen om, at koden har stort behov for en større omskrivning?
Tidligere handling:
- Vi har informeret vores chef om, at koden er et rod
- Vi har vist ham koden (han svarer, "hvad er der galt med det?")
EDIT Jeg er næsten helt sikker på, at en omskrivning er nødvendig. Jeg undskylder alle de ikke-pythonistas derude, men koden ser sådan ud:
def index (anmodning): return render (anmodning, 'index.html', locals ())
gentaget for måske 20 af de 30 "visnings" -funktioner i koden. For dem af jer, der ikke forstår, kræver denne type kode i det væsentlige hvert medlem af teamet at huske, hvad der bruges til hver skabelon, og gør det vanskeligt at ændre koden uden at bryde noget. Fra hvad jeg kunne fortælle, havde den tidligere udvikler ikke mere end 1 års erfaring med kodning og måske ingen professionelt. Koden er ret ujævn lige nu, og ingen kan helt finde ud af, hvor / hvorfor.
Hvis det ændrer noget, er dette en nonprofit forskningsorganisation, så gribende markedsandel er ikke det vigtigt, men da medlemmer generelt forbliver i ca. et år (mens de udfører deres post-doc-arbejde), tror jeg, at læsbarhed / vedligeholdelsesvenlighed sandsynligvis er den største enkeltstående ting, vi har brug for (bortset fra funktionalitet).