Η παγίδα της γνώσης του δημιουργού
Ως μηχανικοί, συχνά πέφτουμε στην παγίδα να θεωρούμε ότι οι οδηγίες μας είναι αυτονόητες. Όταν γράφουμε ένα README, παραλείπουμε κρίσιμα βήματα επειδή τα έχουμε εσωτερικεύσει, όπως η χρήση του sudo, η ανάγκη για επανεκκίνηση ή η διαφορά μεταξύ -foo και --foo. Αυτά τα κενά αποτελούν σοβαρά σημεία συμφόρησης (bottlenecks) για τον νέο χρήστη.
Η αξία της ζωντανής δοκιμής
Ο Terence Eden επέλεξε μια ριζοσπαστική προσέγγιση: πλήρωσε πραγματικούς χρήστες για να ακολουθήσουν τις οδηγίες του ενώ μοιράζονταν την οθόνη τους και τις σκέψεις τους. Η διαδικασία αυτή αποκάλυψε προβλήματα που κυμαίνονταν από λανθασμένους συνδέσμους και ασαφή ορολογία, μέχρι θεμελιώδη λάθη στη δομή της τεκμηρίωσης. Η άμεση επικοινωνία επέτρεψε στον συγγραφέα να αντιληφθεί πού ακριβώς «κολλάει» ο χρήστης, κάτι που κανένα spell checker ή LLM δεν μπορεί να προσομοιώσει με την ίδια ακρίβεια.
Ανθρώπινη αλληλεπίδραση έναντι αυτοματοποίησης
Παρά την άνοδο της παραγωγικής τεχνητής νοημοσύνης (Generative AI), η ανθρώπινη ανατροφοδότηση παραμένει αναντικατάστατη. Η ικανότητα να ακούς την απογοήτευση στη φωνή κάποιου όταν αποτυγχάνει να εγκαταστήσει το λογισμικό σου είναι το ισχυρότερο εργαλείο για τη βελτίωση της εμπειρίας χρήστη (UX). Η τεκμηρίωση δεν είναι απλώς κείμενο, είναι η πρώτη διεπαφή (interface) του προϊόντος σου με τον κόσμο.