Θεμέλια: ανάγνωση του αρχείου επαλήθευσης ενός build

Πριν από τρεις εβδομάδες έφτιαξα ένα widget κρατήσεων για μια φίλη που διευθύνει ένα στούντιο γιόγκα — μια συνομιλία, ένα πλάνο που ενέκρινα γρήγορα γιατί ήμουν στη μέση κάτι άλλου, μια εκτέλεση, και μετά μια κάρτα έκδοσης με ένα πράσινο τικ που ρίξα μια ματιά και προχώρησα. Την Τρίτη μου έστειλε μήνυμα ρωτώντας αν θα μπορούσε να δείξει σε ένα δεύτερο στούντιο την ίδια δημιουργία. Πριν πω ναι, πήγα πίσω να δω τι σήμαινε πραγματικά το "επαληθευμένο" τρεις εβδομάδες πριν, και τότε ήταν που διάβασα πραγματικά ένα από αυτά τα αρχεία για πρώτη φορά αντί απλώς να εμπιστευτώ το τικ.

Βρίσκεται ακριβώς πάνω στην κάρτα έκδοσης, δίπλα στην προεπισκόπηση και τις ενέργειες κώδικα — στο ίδιο σημείο όπου θα πήγαινες για επαναδημοσίευση ή επαναφορά. Το πρώτο πράγμα που πρόσεξα: αφορά αποκλειστικά αυτή τη μία έκδοση, όχι όλη τη συνομιλία. Είχα επαναλάβει αυτή τη δημιουργία πέντε φορές κυνηγώντας ένα σπασμένο date picker, και περίμενα μισό-μισό ότι το αρχείο θα μου έλεγε την ιστορία όλης της αλληλεπίδρασης. Δεν το κάνει. Το αρχείο της έκδοσης 4 περιγράφει μόνο την έκδοση 4. Δεν έχει καμία μνήμη ότι η έκδοση 2 στάλθηκε με μια φόρμα σύνδεσης που απέτυχε σιωπηλά, και δεν θα μου πει ότι η έκδοση 5 διόρθωσε ήσυχα κάτι που έσπασε η έκδοση 3. Κάθε αρχείο είναι ένα στιγμιότυπο, όχι diff και όχι ημερολόγιο αλλαγών — αν θέλω το ιστορικό του τι άλλαξε από έκδοση σε έκδοση, αυτό είναι εντελώς διαφορετική προβολή. Αυτό απαντά μόνο στο "είναι αυτή εντάξει".

Κατεβαίνοντας, το αρχείο χωρίζεται σε έξι γραμμές:

Και τα έξι ήταν πράσινα, και το πρώτο μου ένστικτο ήταν το ίδιο λάθος ένστικτο που υποθέτω ότι έχουν οι περισσότεροι: πέρασε η ασφάλεια, άρα είναι ασφαλές· πέρασε η προσβασιμότητα, άρα είναι προσβάσιμο. Καμία από αυτές τις αναγνώσεις δεν επιβιώνει από την επαφή με το τι κάνουν πραγματικά οι έλεγχοι. Το πέρασμα ασφάλειας σημαίνει ότι τα επιφανειακά πράγματα — συνένωση strings σε ένα query, ένα API key εκτεθειμένο στο client bundle, ένα eval σε κάτι που πληκτρολόγησε ένας χρήστης — δεν εμφανίστηκαν. Δεν είναι μια μέρα με έναν pentester. Το στούντιο της φίλης μου δεν δέχεται πληρωμές μέσω αυτού του widget, μόνο ονόματα και ώρες, οπότε το επίπεδο ήταν αρκετό για εκείνη. Αν επρόκειτο για ροή πληρωμής, θα ήθελα κάτι παραπάνω από ένα βασικό επίπεδο.

Η προσβασιμότητα είναι αυτή που με έκανε πραγματικά να σταματήσω και να ψάξω κάτι, γιατί το "πέρασμα axe" ακούγεται εξαντλητικό αλλά δεν είναι. Το axe — η αυτοματοποιημένη μηχανή που τρέχει από κάτω — πιάνει αξιόπιστα κάτι σαν το ένα τρίτο έως τη μισή από τα κριτήρια επιτυχίας WCAG: κείμενο alt που λείπει, κακή αναλογία αντίθεσης, χωρίς ετικέτα πεδία φόρμας, προφανή κακή χρήση ARIA. Δεν μπορεί να σου πει αν το προσαρμοσμένο dropdown του date picker που είχα ζητήσει είναι χρησιμοποιήσιμο με screen reader, αν η πλοήγηση με tab στη ροή κρατήσεων πολλών βημάτων φέρνει την εστίαση κάπου λογικό, ή αν η κατάσταση "επιβεβαιωμένο" έναντι "σε εκκρεμότητα" που είχα χρωματίσει πράσινο και κίτρινο είναι πρόβλημα για κάποιον με αχρωματοψία κόκκινου-πράσινου. Αυτά χρειάζονται έναν άνθρωπο να περάσει τη δημιουργία με τα εργαλεία που χρησιμοποιούν πραγματικά άτομα με αναπηρίες. Το axe είναι πραγματικό σήμα, όχι τίποτα — είναι το επίπεδο ορθογραφικού ελέγχου της προσβασιμότητας, όχι ο επιμελητής.

Η Συμμόρφωση ήταν η γραμμή που παραλίγο να προσπεράσω, γιατί ακούγεται γραφειοκρατική — «περιέχει ό,τι υποσχέθηκε το πλάνο» — μέχρι που θυμήθηκα ότι το πλάνο που είχα εγκρίνει γράφτηκε ενώ ήμουν αφηρημένος, και ειλικρινά δεν μπορούσα να θυμηθώ αν είχα ζητήσει επιβεβαιώσεις email ή απλώς SMS. Αυτό είναι το επίπεδο που ελέγχει το build σε σχέση με το πλάνο, όχι σε σχέση με την πραγματική μου πρόθεση, και πέρασε, κάτι που μου έδειξε ότι το build ταίριαζε με αυτό που είχα πει «ναι», όχι απαραίτητα με αυτό που εννοούσα. Έχω ακούσει για builds που ήταν λειτουργικά άρτια και ασφαλή και παρόλα αυτά απέτυχαν σε αυτό το επίπεδο επειδή ένα χαρακτηριστικό αφαιρέθηκε αθόρυβα υπό πίεση χρόνου. Είναι το επίπεδο που κρατά ένα build ειλικρινές απέναντι στη συζήτηση που το γέννησε, ακόμα κι όταν η ίδια η συζήτηση ήταν λίγο πρόχειρη.

Κάτω από τις έξι γραμμές υπήρχε μια μεγαλύτερη λίστα, χωρισμένη σε δύο κατηγορίες, και εκεί πέρασα τον περισσότερο χρόνο. Τα στοιχεία «απαιτείται διόρθωση» δεν είναι πράγματα που είναι σήμερα λάθος στο build — είναι αποδείξεις. Μια γραμμή ανέφερε ότι το επίπεδο ελέγχου είχε επισημάνει μια περίπτωση όπου μια συμβολοσειρά ημερομηνίας παρεμβαλλόταν απευθείας σε ένα ερώτημα, και είχε ήδη διορθωθεί πριν αυτή η έκδοση χαρακτηριστεί ολοκληρωμένη. Δεν κοιτούσα μια ανοιχτή πληγή· κοιτούσα μια ουλή. Αυτή η διάκριση έχει σημασία, γιατί αν διαβάσεις μια καταχώρηση «απαιτείται διόρθωση» ως ζωντανή προειδοποίηση θα ξοδέψεις χρόνο ανησυχώντας για κάτι που έχει ήδη κλείσει.

Η λίστα συμβουλευτικών σημειώσεων ήταν πιο μεγάλη, και ήταν κυρίως πράγματα που θα έλεγα κι εγώ ο ίδιος αν έκανα review στον κώδικα ενός συναδέλφου χωρίς να θέλω να μπλοκάρω το merge: «σκέψου να εξάγεις το επαναλαμβανόμενο block απόδοσης θέσεων σε ένα κοινό component», «αυτό το endpoint δεν έχει περιορισμό ρυθμού (rate limiting), κάτι που είναι εντάξει για ένα εσωτερικό εργαλείο κρατήσεων αλλά αξίζει επανεξέτασης αν γίνει δημόσιο». Τίποτα σε αυτή τη λίστα δεν ήταν ελάττωμα. Ήταν κρίσεις που έκανε ένας ελεγκτής έχοντας μόνο το πλάνο και τον κώδικα ως δεδομένα, και για το εσωτερικό πρόγραμμα κρατήσεων ενός στούντιο yoga, κάθε μία από αυτές τις κρίσεις έπεσε στη λογική πλευρά. Αν το στούντιο του φίλου μου ήταν αλυσίδα με το widget ενσωματωμένο σε πενήντα σελίδες τοποθεσιών, θα ήθελα να αντισταθώ στο θέμα του rate-limiting — η κατηγοριοποίηση εξαρτάται από πλαίσιο που ο ελεγκτής μπορεί μόνο να μαντέψει, και όταν μια εικασία σου φαίνεται λάθος, η σωστή κίνηση είναι να το πεις στο chat, όχι να υποθέσεις ότι η ετικέτα είναι τελική.

Αυτό που μου έκανε εντύπωση, κοιτάζοντας μια αρκετά μεγάλη λίστα συμβουλευτικών σημειώσεων δίπλα σε μια καθαρή στήλη «απαιτείται διόρθωση», είναι ότι παραλίγο να διαβάσω το μήκος της ως κακά νέα. Δεν είναι. Ένα build με μηδέν συμβουλευτικές σημειώσεις είτε πέρασε στενά είτε είχε τύχη· ένα build με έναν σωρό στοιχεία «σκέψου να» και τίποτα εκκρεμές στη στήλη «απαιτείται διόρθωση» είναι ένα build που έχει πράγματι εξεταστεί προσεκτικά. Η στήλη των συμβουλευτικών σημειώσεων είναι αυτό που πρέπει να απομένει αφού φύγουν τα πραγματικά προβλήματα.

Το άλλο πράγμα που φρόντισα να κάνω, αφού αυτή η εγγραφή ήταν τριών εβδομάδων παλιά, ήταν να ελέγξω ποια επίπεδα όντως εκτελέστηκαν πριν εμπιστευτώ καθόλου τις κρίσεις. Και τα έξι ήταν παρόντα εδώ, αλλά έχω δει έκτοτε ένα build όπου η προσβασιμότητα απλώς έλειπε από τη λίστα αντί να σημειωθεί ως επιτυχία ή αποτυχία — αυτό δεν είναι το ίδιο με το να παραλειφθεί ως ασήμαντο, είναι ένδειξη ότι ο έλεγχος δεν εκτελέστηκε για εκείνον τον συγκεκριμένο τύπο ιστοτόπου ή διαμόρφωση σημαιών, και το να διαβάζεις την απουσία ως σιωπηλή επιτυχία είναι ακριβώς το λάθος που προκαλεί αυτή η μορφή αν απλώς κοιτάς επιφανειακά.

Τίποτα από όλα αυτά δεν μου έλεγε αν η ροή κρατήσεων του στούντιο yoga όντως μετατρέπει, αν οι άνθρωποι εγκαταλείπουν στο βήμα επιλογής ώρας, ή αν όλη η ιδέα ενός προσαρμοσμένου widget αντί απλώς σύνδεσης με το Calendly ήταν η σωστή επιλογή εξαρχής. Η επαλήθευση αποδεικνύει ότι ένα build λειτουργεί όπως υποσχέθηκε, όχι ότι η υπόσχεση ήταν η σωστή να δοθεί — αυτά είναι ξεχωριστά ερωτήματα, και έχω δει builds να περνούν κάθε επίπεδο καθαρά και παρόλα αυτά να αποτυγχάνουν με πραγματικούς χρήστες γιατί το «λειτουργεί σωστά» και το «λύνει το σωστό πρόβλημα» δεν επικαλύπτονται όσο θα ήθελες. Το μισό από αυτό που πραγματικά απαντά στο δεύτερο ερώτημα είναι ο βρόχος μέτρησης, και τα δύο προορίζονται να διαβαστούν μαζί. Μια καθαρή εγγραφή επαλήθευσης σε ένα χαρακτηριστικό που κανείς δεν κλείνει μέσω αυτού παραμένει ένα χαρακτηριστικό που κανείς δεν χρησιμοποιεί.