Γράφει ο Terry Zink*:
“It gets tense when stuff breaks that hasn’t broken in a long time because nobody can remember how to fix it. When you do it once and then leave it, it doesn’t always stick in our memories.”
Είχα την εντύπωση πως σε οργανισμούς που δουλεύουν με παραπάνω από 1,5 Postmaster δεν συμβαίνουν αυτά…
[*] – Ο Terry Zink εργάζεται στο Microsoft Exchange Hosted Services antispam division.
Managing organized complexity 
Χαχα, ξέρεις τι μου θυμίζει αυτό τώρα;
Το αμίμητο “Μα ΦΥΣΙΚΑ ο κώδικας είναι το καλύτερο documentation!”
Ας γελάσω… Όταν ακούω κάποιον να μου το λέει αυτό καταλαβαίνω πολλά για το πόσο έμπειρος είναι… Για το πόσα σκατά ΔΕΝ έχει φάει ακόμα.
Τα specs και τα comments είναι το documentation του κώδικα. Τα comments π.χ. μας λένε την ΠΡΟΘΕΣΗ του προγράμματος σε ένα δεδομένο σημείο. Ο κώδικας είναι απλά το *interpretation* από τον προγραμματιστή της κατανόησης που έχει για αυτή την πρόθεση.
Και εννοείται ο αντίλογος είναι “Μα αν γράφω σχόλια τότε θα έχω να συντηρώ και τα σχόλια κάθε φορά που αλλάζω τον κώδικα”. Ας γελάσω και πάλι. ΦΥΣΙΚΑ και θα τα συντηρείς. Τα σχόλια είναι τμήμα του κώδικα, συνεπώς τα συντηρούμε ΚΑΙ αυτά κανονικά σαν να ήταν κώδικας. Duh…
Εντελώς τυχαία τις τελευταίες 2 εβδομάδες ασχολούμαι κυρίως με documentation updates (manuals). Είναι τραγικό το πόσο οι σύγχρονοι “developers” σκοτώνονται να φτιάξουν το ένα ή το άλλο feature και μετά βαριούνται να γράψουν το σχετικό documentation. Αντί να σκοτωθούν να εκθειάσουν το κάθε feature, που οι ίδιοι κουράστηκαν να υλοποιήσουν, να εξηγήσουν γιατί το χρειάζεται ο χρήστης, να βάλουν screenshots κλπ, ρίχνουν 5 ξερές γραμμές just to get the job done. Μα φυσικά είναι φτιαγμένοι για να δουλεύουν σε μεγάλες εταιρίες με dedicated technical writers, ξέρετε… αυτούς τους ξεπεσμένους τύπους που απέτυχαν να γίνουν προγραμματιστές και κατέληξαν να γράφουν τα manuals instead.
Το άλλο με τον Τοτό το ξέρεις;
Εγώ πάντως αυτούς που έγραφαν το documentation της DEC (π.χ. The Little Gray Book: An ULTRIX Primer) ποτέ δε θα τους έλεγα ξεπεσμένους. Πάντα ζήλευα το πόσο καλά μετέδιδαν το νόημα που ήθελαν.
Ούπς, προφανώς δεν το έλεγα σοβαρά το “ξεπεσμένους”. Εννοούσα ότι οι διάφοροι “προγραμματισταράδες” τους θεωρούν και τους συμπεριφέρονται σαν να είναι ξεπεσούρα. Για αποφυγή παρεξηγήσεων δηλαδή ;-)