Temeller: bir build'in doğrulama kaydını okumak

Üç hafta önce, yoga stüdyosu işleten bir arkadaşım için bir rezervasyon widget'ı yaptım — bir sohbet, başka bir işle uğraşırken hızlıca onayladığım bir plan, bir çalıştırma ve ardından üzerinden geçip baktığım yeşil bir onay işaretiyle bir sürüm kartı. Salı günü bana ikinci bir stüdyonun sitesini aynı derlemeye yönlendirip yönlendiremeyeceğini sordu. Evet demeden önce, üç hafta önce "doğrulandı"nın gerçekte ne anlama geldiğine bakmak için geri döndüm ve işte o zaman, sadece onay işaretine güvenmek yerine bu kayıtlardan birini ilk kez gerçekten okudum.

Tam olarak sürüm kartının üzerinde, önizleme ve kod eylemlerinin yanında duruyor — yeniden dağıtım yapmak veya geri almak için gideceğiniz aynı yer. Fark ettiğim ilk şey: bütün konuşmaya değil, o tek sürüme özgü. Bu derlemeyi bozuk bir tarih seçiciyi kovalarken beş kez üzerinde çalışmıştım ve kaydın bana tüm ileri geri sürecin hikayesini anlatmasını yarı yarıya bekliyordum. Anlatmıyor. Sürüm 4'ün kaydı yalnızca sürüm 4'ü tanımlıyor. Sürüm 2'nin sessizce başarısız olan bir giriş formuyla gönderildiğine dair bir hafızası yok ve sürüm 5'in sürüm 3'ün bozduğu bir şeyi sessizce düzelttiğini size söylemeyecek. Her kayıt bir anlık görüntüdür, bir fark listesi veya değişiklik günlüğü değildir — sürümden sürüme neyin değiştiğinin geçmişini istiyorsanız, bu tamamen farklı bir görünümdür. Bu, yalnızca "bu tek sürüm iyi mi" sorusunu yanıtlar.

Aşağı kaydırınca, kayıt altı satıra ayrılıyor:

Altısı da yeşildi ve ilk içgüdüm herkesin sahip olduğunu tahmin ettiğim aynı yanlış içgüdüydü: güvenlik geçti, demek ki güvenli; erişilebilirlik geçti, demek ki erişilebilir. Bu okumaların ikisi de kontrollerin gerçekte ne yaptığıyla karşılaşınca ayakta kalmıyor. Güvenlik geçişi, yüzeysel şeylerin — bir sorguya string birleştirme, istemci paketinde açıkta duran bir API anahtarı, bir kullanıcının yazdığı şey üzerinde bir eval — ortaya çıkmadığı anlamına gelir. Bu bir sızma testi uzmanıyla geçirilen bir gün değil. Arkadaşımın stüdyosu bu widget üzerinden ödeme almıyor, sadece isim ve zaman dilimi alıyor, o yüzden taban onun için yeterliydi. Bir ödeme akışı olsaydı, bir tabandan fazlasını isterdim.

Erişilebilirlik, beni gerçekten durup bir şeyi araştırmaya iten satırdı, çünkü "axe geçişi" kapsamlı gibi görünüyor ama değil. Perde arkasında çalışan otomatik motor olan Axe, WCAG başarı kriterlerinin üçte biri ila yarısı gibi bir kısmını güvenilir şekilde yakalar: eksik alt metin, kötü kontrast oranları, etiketsiz form alanları, bariz ARIA yanlış kullanımı. İstediğim özel tarih seçici açılır menüsünün ekran okuyucuyla kullanılabilir olup olmadığını, çok adımlı rezervasyon akışında Tab tuşuyla ilerlerken odağın mantıklı bir yere gidip gitmediğini veya "onaylandı" ile "beklemede" durumunu yeşil ve sarı yaptığımda bunun kırmızı-yeşil renk körlüğü olan biri için sorun olup olmadığını söyleyemez. Bunlar, engelli kullanıcıların gerçekten güvendiği araçlar devre dışı bırakılmış şekilde derlemeyi gözden geçiren bir kişi gerektirir. Axe gerçek bir sinyaldir, hiç yoktur demek değildir — erişilebilirliğin yazım denetleyicisi katmanıdır, editör değil.

Uygunluk, neredeyse atlayacağım satırdı, çünkü bürokratik geliyor — "planın vadettiklerini içeriyor" — ta ki onayladığım planın dikkatim dağınıkken yazıldığını hatırlayana kadar ve e-posta onayları mı yoksa sadece SMS mi istediğimi gerçekten hatırlayamıyordum. Bu katman, derlemeyi gerçek niyetime değil plana karşı kontrol eder ve geçti, bu da bana derlemenin evet dediğim şeyle eşleştiğini, illa kastettiğim şeyle değil, söyledi. İşlevsel olarak sağlam ve güvenli olup yine de zaman baskısı altında bir özelliğin sessizce düşürülmesi nedeniyle bu katmanda başarısız olan derlemeler duydum. Bu, bir derlemeyi kendisini üreten konuşmaya sadık tutan katmandır, konuşmanın kendisi biraz özensiz olsa bile.

Altı satırın altında, iki gruba ayrılmış daha uzun bir liste vardı ve en çok zamanı burada geçirdim. Mutlaka düzeltilmesi gerekenler öğeleri derlemede şu anda yanlış olan şeyler değil — bunlar makbuzlar. Bir satır, inceleme katmanının bir tarih dizesinin doğrudan bir sorguya enterpole edildiği bir durumu işaretlediğini ve bunun bu sürüm tamamlanmış olarak işaretlenmeden önce zaten yamalandığını belirtiyordu. Açık bir yaraya bakmıyordum; bir yara izine bakıyordum. Bu ayrım önemli, çünkü bir mutlaka-düzeltilmeli girişini canlı bir uyarı olarak okursanız, zaten kapatılmış bir şey için endişelenerek zaman harcarsınız.

Tavsiye niteliğindeki liste daha uzundu ve büyük çoğunluğu, birleştirmeyi engellemek istemeden bir meslektaşımın kodunu inceliyor olsaydım kendimin de söyleyeceği şeylerdi: "tekrar eden zaman dilimi render bloğunu paylaşılan bir bileşene çıkarmayı düşünün," "bu uç noktada hız sınırlaması yok, dahili bir rezervasyon aracı için sorun değil ama halka açık hale gelirse yeniden düşünülmeye değer." O listede hiçbir şey bir kusur değildi. Bunlar bir doğrulayıcının yalnızca plan ve koda dayanarak verdiği değer yargılarıydı ve bir yoga stüdyosunun dahili planlayıcısı için, bu yargıların her biri makul tarafa düşüyordu. Arkadaşımın stüdyosu widget'ı elli konum sayfasına gömülü bir franchise olsaydı, hız sınırlama konusunda itiraz etmek isterdim — sınıflandırma, doğrulayıcının ancak tahmin edebileceği bağlama bağlıdır ve bir tahmin size yanlış görünürse, doğru hamle etiketin kesin olduğunu varsaymak değil, sohbette bunu söylemektir.

Temiz bir mutlaka-düzeltilmeli sütununun yanında oldukça uzun bir tavsiye listesine bakınca dikkatimi çeken şey, uzunluğunu neredeyse kötü haber olarak okuyabilecek olmamdı. Değil. Sıfır tavsiye notu olan bir derleme ya dar bir geçiş almıştır ya da şanslıdır; mutlaka-düzeltilmeli kısmında bekleyen hiçbir şey olmadan bir yığın "düşünün" öğesi olan bir derleme ise gerçekten dikkatle incelenmiş bir derlemedir. Tavsiye sütunu, gerçek sorunlar gittikten sonra geriye kalması gereken şeydir.

Bu kayıt üç hafta bayat olduğundan kendime yaptırdığım bir diğer şey, kararları güvenmeden önce hangi katmanların gerçekten çalıştığını kontrol etmekti. Burada altısı da mevcuttu, ama o zamandan beri erişilebilirliğin geçti veya kaldı olarak işaretlenmek yerine listede sadece eksik olduğu bir derleme gördüm — bu, önemsiz olduğu için atlanmakla aynı şey değil, o belirli site türü veya bayrak yapılandırması için kontrolün çalışmadığının bir işareti ve göz gezdiriyorsanız yokluğu sessiz bir geçiş olarak okumak, tam olarak bu formatın davet ettiği hatadır.

Hiçbiri bana yoga stüdyosunun rezervasyon akışının gerçekten dönüşüm sağlayıp sağlamadığını, insanların zaman dilimi adımında vazgeçip vazgeçmediğini veya sadece Calendly'ye bağlantı vermek yerine özel bir widget fikrinin baştan doğru bir karar olup olmadığını söylemedi. Doğrulama, bir derlemenin vaat edildiği gibi çalıştığını kanıtlar, vaadin doğru olduğunu kanıtlamaz — bunlar ayrı sorulardır ve derlemelerin her katmandan tertemiz geçip yine de gerçek kullanıcılarla başarısız olduğunu gördüm, çünkü "doğru çalışıyor" ile "doğru sorunu çözüyor" umduğunuz kadar örtüşmüyor. Bunun ikinci soruyu gerçekten yanıtlayan yarısı ölçüm döngüsüdür ve ikisinin birlikte okunması amaçlanmıştır. Kimsenin rezervasyon yapmadığı bir özellikteki temiz bir doğrulama kaydı, yine de kimsenin rezervasyon yapmadığı bir özelliktir.