Geliştirici deneyimi nasıl iyileştirilir: tek kişilik rehber
Summary
Geliştirici deneyimi, kod değiştirip sonucu görmek arasındaki döngüyü kısaltmaktan ibarettir. Önce döngüyü kronometreyle ölçün, sonra kurulumu tek komuta indirin, yalnızca değişen testleri çalıştırın ve yavaş adımları önbelleğe alın. Ardından bilişsel yükü karar kayıtlarıyla azaltın, yapay zeka araçlarını bir bekleme süresini kaldırdıkları yerde kullanın ve odak için haftalık oturumlar ayırın. Her ay aynı dört sayıyı yeniden ölçmek, ne işe yaradığını gösterir.
Geliştirici deneyimi nasıl iyileştirilir sorusunun cevabı tek bir hamlede toplanıyor: "bir satır değiştirdim" ile "işe yaradı mı, bunu biliyorum" arasındaki döngüyü kısaltın, ardından düşünebildiğiniz saatleri koruyun. Yavaş derlemeleri, kararsız testleri, zahmetli kurulumu ve gereksiz kesintileri bu sırayla düzeltin. Yapay zeka araçlarını ise yeni bir inceleme yükü yaratmak yerine bir bekleme süresini ortadan kaldırdıkları yerde kullanın.
Asıl gözden kaçan nokta şu: tek başınıza çalışan bir geliştirici için siz platform ekibisiniz, müşterisiniz ve gece yarısı alarm alan kişisiniz. Bu bir avantaj. Bu hafta canınızı sıkan şeyi bu hafta düzeltebilirsiniz, gelecek çeyreği beklemeniz gerekmez.
Tek başınayken geliştirici deneyimi aslında ne anlama gelir?
Geliştirici deneyimi üzerine yazılan rehberlerin çoğu, anket bütçesi ve platform ekibi olan şirketler için yazılmış. Yine de fikirler aktarılabilir, çünkü arkasındaki araştırma sade. ACM Queue'da yayımlanan ve DevEx araştırmacılarından oluşan bir ekibin çalışması, DevEx'i üç boyuta ayırıyor: geri bildirim döngüleri, bilişsel yük ve akış hâli.
Geri bildirim döngüleri, araçlarınızdan ya da başka insanlardan yanıt almak için ne kadar beklediğiniz demek. Bilişsel yük, bir değişiklik yapmak için kafanızda ne kadar şey tutmanız gerektiği. Akış hâli ise zor kısımlara girebilmek için yeterince uzun odak anları bulup bulamadığınız.
Bunların hiçbirini soyut kavramlar olarak hissetmezsiniz. Test paketini çalıştırmaktan kaçınmak, iki hafta uzak kaldıktan sonra dokunmaya korktuğunuz bir depo ve her dört dakikada bir ötüp duran dizüstü bilgisayar olarak hissedersiniz.
Microsoft'un bu araştırmayı anlatan yazısı akılda tutmaya değer sayılar veriyor. Derin çalışma için belirgin zaman ayıran geliştiriciler, ayırmayanlara kıyasla kendilerini yüzde 50 daha verimli hissetti ve soruları hızlı yanıtlayan ekipler teknik borçlarının yüzde 50 daha az olduğunu bildirdi. Bunlar bir anketten çıkan algı bazlı bulgular, kontrollü bir deney değil. Bu yüzden onları bir yön olarak okuyun, bir garanti olarak değil.
Yan proje için çeviri açık: geliştirici deneyiminiz, salı gecesi saat 22:00'de çalışan bir özelliğe ulaşmanızın önündeki küçük sürtünmelerin toplamıdır.
Nereden başlamalı: düzeltmeden önce döngüyü ölçün
En sık tekrarladığınız tek döngüyü seçin. Çoğumuz için bu şudur: düzenle, kaydet, sonucu gör. Hissiyatla değil, kronometreyle ölçün.
Kabaca bir ölçek:
1 saniyenin altı: sıcak yükleme ya da izleme modu anlık hissettirir, problemin içinde kalırsınız.
1 ila 10 saniye: kabul edilebilir. Başka bir pencereye bakabilirsiniz ama konuyu kaybetmezsiniz.
10 ila 60 saniye: telefonunuza bakacaksınız. Odak burada sızmaya başlar.
Bir dakikanın üzeri: değişiklikleri toplu yaparsınız, bu da daha büyük hatalar ve daha zor hata ayıklama demek.
Test çalıştırmanız, tam derlemeniz ve dağıtımınız için de aynısını yapın. Dört sayıyı deponun başındaki bir nota yazın. Bu not başlangıç noktanız olur ve bir sonraki düzeltmeyi somutlaştırır.

Daha büyük ekiplerin tavsiyeleri bunu doğruluyor. Swarmia'nın rehberi, bekleme sürelerini tek tek ve en basitlerinden başlayarak ele almayı öneriyor. Bunun nedeni, önceliklendirmeyi zorunlu kılması ve etkiyi görünür kılması. Bu, elli kişilik bir ekip için ne kadar geçerliyse tek bir kişi için de o kadar geçerli.
Kronometreye güvenin, sezgiye değil. En yavaş hissettiren döngü, en çok zaman kaybettiren döngü olmayabilir. Günde 300 kez çalıştırdığınız 12 saniyelik bir tip kontrolü, iki kez çalıştırdığınız 4 dakikalık bir dağıtımdan daha pahalıya gelir.
En ucuz sürtünme hangisi, önce onu kaldırın
Bazı düzeltmeler bir öğleden sonra sürer ama aylarca geri döner. Süslü şeylerden önce bunları yapın.
Kurulumu tek komuta indirin. Temiz bir klonlama tek bir make dev ya da npm run dev ile çalışmıyorsa, her gelecekteki bağlam değişimine vergi koyuyorsunuz. Bir ay sonra projeye döndüğünüzdeki değişim de buna dahil. Adımları bir README paragrafına değil, bir betiğe koyun.
# bootstrap.sh: bir projenin ihtiyaç duyduğu tek kurulum adımı
set -euo pipefail
cp -n .env.example .env
npm ci
npm run db:migrate
echo "hazır: npm run dev çalıştırın"Yalnızca değişeni çalıştırın. Test çalıştırıcınızın izleme ve ilgili dosyalar modunu kullanın. Böylece bir kaydetme işlemi 900 testin tamamını değil, etkilenen üç testi çalıştırsın. Modern çalıştırıcıların çoğu bunu kutudan çıktığı gibi destekler.
Yavaş olanı önbelleğe alın. Bağımlılık kurulumları, Docker katmanları ve derleme çıktıları en sık suçlular. CI her şeyi yeniden kurduğu için 8 dakika sürüyorsa, lock dosyanızdan türetilen bir önbellek anahtarı bunu çoğu zaman 3 dakikanın altına indirir.
Kararsız testleri bugün silin ya da düzeltin. Kararsız bir test size kırmızıyı görmezden gelmeyi öğretir. İdeal değil ama yine de yapmaya değer: onu ayrı bir işe taşımak, ana çalıştırmada bırakmaktan iyidir. Yeter ki düzeltme için bir tarih koyun.
Kaydederken biçimlendirin ve lint çalıştırın. Stil tartışmaları dikkat harcar. Bu kararları araca bırakın ve devam edin.
Bunların hiçbiri heyecan verici değil. Asıl mesele de bu. Her madde, haftada onlarca kez verdiğiniz bir kararı ortadan kaldırıyor.
Bir de sıralama meselesi var. Bu listedeki maddeleri yaparken her birinin ne kadar zaman kazandırdığını ölçün ve sonucu ilk ölçtüğünüz dört sayının yanına yazın. Bir değişiklik bir dakikayı bile kurtarmıyorsa, onu bir sonraki haftaya bırakmak sorun değil. Önemli olan, kazanımın görünür olması ve bunu bir sonraki kararınızda kullanabilmeniz.
Kod tabanınız ne kadar bilişsel yük ekliyor?
Yan projeler tek belirli bir biçimde yaşlanır: neyin neden öyle olduğunu unutursunuz. Üç ay sonra kod, adınızı paylaşan bir yabancının yazdığı bir bulmacaya dönüşür.
En ucuz savunma, parlatılmış dokümantasyon değil karar kaydı tutmaktır. Her seçim için bir paragraflık bir DECISIONS.md dosyası ("Tüm veri seti belleğe sığdığı için SQLite kullandım, 50 bin satırın üzerinde yeniden değerlendir") bir README'den daha fazla zaman kazandırır. Thoughtworks, mimari karar kayıtları gibi dokümantasyonu DX'in dört temel unsurundan biri olarak sayıyor. Tek kişilik versiyon ise aynı fikrin on kat daha hafif hâli.

Yapıyı ağırlaştırmadan yükü azaltan üç alışkanlık:
Şeyleri yaptıkları işe göre adlandırın ve bir isim artık doğru olmadığında hızlıca değiştirin.
Her yaygın görev için tek ve belirgin bir yol tutun: veri çekmek için tek yol, hataları işlemek için tek yol, yapılandırma için tek yer.
Her oturumun sonunda başarısız bir test ya da
TODO(next)yorumu bırakın. Böylece yarın boş bir bakışla değil, bir sonraki adımla başlarsınız.
Burada ağır mimariden kaçının. 2.000 satırlık bir uygulama için on katmanlı bir klasör yapısı yükü azaltmaz, artırır. Yapıyı bir şey acıttığında ekleyin, önce değil.
Yapay zeka araçları geliştirici deneyimini mi iyileştiriyor, yoksa acıyı başka yere mi taşıyor?
İkisi de, nereye yönelttiğinize bağlı. Aylarca günlük kullanımdan sonra dürüst cevap şu: yapay zeka araçları şablon kod, arama ve ilk taslak gibi işlerde parlıyor. Anlamadığınız bir çıktıyı kabul ettiğinizde ise bedelini ödetiyorlar.
Benimsemeyi önerdiğim sırayla iyi kullanımlar:
Satır içi tamamlama. Tekrarlayan kod için düşük risk ve anlık geri bildirim. Zaten her satırı okuyorsunuz.
Tanımadığınız kodu ya da bir hata izini açıklatmak. Bu, bilişsel yükü ve arama süresini doğrudan azaltır.
Zaten yazdığınız kod için test yazdırmak. Sıkı inceleyin, ama ilk taslak gerçek zaman kazandırır.
Mekanik yeniden düzenlemeler için dosyalar arası ajan düzenlemeleri. Temiz bir git durumuyla çalışın ki sonucu gerekirse atabilesiniz.
Araçlar nerede yaşadıklarına göre farklılaşıyor. Bazıları editörde, bazıları terminalde, bazıları çekme isteği akışınızda yer alıyor:
Terminal öncelikli çalışma için depoyu okuyup komut çalıştıran bir ajan, bir editör eklentisinden farklı bir alışkanlığa uyuyor:
DX bakış açısının bariz hâle getirdiği bir uyarı var. Bir araç kod yazmayı hızlandırıp incelemeyi yavaşlatıyorsa, beklemeyi bir döngüden diğerine taşımış olursunuz. Kendi inceleme sürenizi izleyin. Yazarak kazandığınızdan fazla dakikayı üretilmiş diff'leri okuyarak harcıyorsanız, istediğiniz kapsamı küçültün.
Bir diğer kaçınılacak şey de ajana belirsiz bir hedef verip uzaklaşmak. Ona çalıştırabileceği bir kontrolü olan tek bir küçük görev verin, örneğin başarısız bir test. Sonucu o kontrolün geçip geçmediğine göre değerlendirin.
Odak süresini nasıl koruyorsunuz ki diğer her şey işe yarasın?
Microsoft araştırmasındaki derin çalışma sayısı, sınırlarına rağmen ilk harekete geçeceğim sayı. Odak, bu makaledeki diğer her düzeltmenin çarpanıdır.
Tek başına çalışanlar genellikle odağı kendilerine kaptırır: bildirimler, sekmeler, yeni bir framework sürümü, analitiğe bakma hissi. Çözümler sıkıcı ama işe yarıyor:
Haftada en az 90 dakikalık en az iki oturumu, bildirimler ve sohbet kapalıyken ayırın.
Oturmadan önce ne inşa ettiğinize karar verin. Editörü "bakalım ne olacak" diye açmak, bir saatin nasıl kaybolduğunun yoludur.
Bir park listesi dosyası tutun. Yan bir fikir geldiğinde bir satır yazın ve işinize dönün.
Her oturumu düşüncenin ortasında değil, temiz bir durma noktasında bitirin, not bırakmıyorsanız.

Serbest çalışıp farklı saat dilimlerinde müşteri alan biriyseniz, Taipei, Bangkok ya da Manila'daki birçok geliştirici gibi, örtüşen saatlerinizi farklı koruyun. Müşteri görüşmelerini sıkı bir blokta toplayın ve kalanını inşa etmeye ayırın. Tek bir 20 dakikalık kesinti, 20 dakikalık odağın çok ötesinde bir bedel getirebilir.
İşe yaradığını nasıl anlarsınız? Neyi ölçmelisiniz?
Panel kurmayın. Bir hafta boyunca sayıların nasıl değiştiğini bir deftere not etmek, aylarca bakılmayan bir gösterge panelinden çok daha fazla işe yarar. Aynı dört sayıyı her ay yeniden ölçün: düzenleme-sonuç, test çalıştırması, tam derleme ve dağıtım. Bir beşincisini ekleyin: 1 ila 5 arası bir sezgisel puan, "bu hafta inşa etmek ne kadar sinir bozucuydu?" sorusuna verilen cevap.
Algı ölçüsü önemli. Microsoft makalesi, geliştiricilerin hissettiklerini iş akışı verisiyle eşleştirir, çünkü ikisi birbirinden ayrılabilir. Bir inceleme süreci grafikte hızlı görünüp yine de rahatsız edici hissettirebilir. Tek bir kişi için de aynı mantık geçerli. Sayılar iyileşiyor ama sezgisel puan iyileşmiyorsa, başka bir şey yanlıştır ve genellikle bu odak ya da kapsamdır.
Ödünleşimleri de adlandırmak gerekir: her iyileştirmenin bir bakım maliyeti var. Özel bir betik de kırılabilecek bir şey demek. Tek katkıcılı bir proje için süslü bir monorepo kurulumu kazandırdığından fazla maliyet çıkarabilir. Sıradan varsayılanları tercih edin ve bir şey sizi iki kez ısırmadan düzeltmeyin.
Başlayacağınız proje için hangi DX iyileştirmesi uygun?
Hâlâ ne inşa edeceğinize karar veriyorsanız, DX'i bir seçim kriteri olarak kullanın. Hızlı bir döngüsü, küçük bir yığını ve net bir kapsamı olan proje üçüncü haftayı atlatır. Çoğu hafta sonu projesinin öldüğü nokta da burasıdır. Tek bir piksel görmeden yerelde beş servis çalıştırmanızı isteyen proje ise çoğu zaman ayakta kalmaz.
Bir proje fikrini değerlendirirken bir de şunu düşünün: Bu fikir ilk hafta sonunda bir sonuç üretebiliyor mu? Eğer üretemiyorsa, fikrin kendisi değil, ilk sürümünün tanımı büyük ihtimalle fazla geniştir. Bu durumda kapsamı daraltmak, çoğu zaman yeni bir çatı ya da yeni bir veritabanı seçmekten daha etkili olur.
Bağlanmadan önce üç soru sorun: Sonucu on saniyenin altında görebiliyor muyum? Temiz bir klon tek komutla çalışıyor mu? İlk sürümü iki cümleyle anlatabiliyor muyum? Üç evet iyi bir işaret. İki hayır ise standartları değil, fikri küçültün.
Mükemmel bir fikir değil bu, uygulanabilir bir fikir. Ve hızlı bir döngüsü olan uygulanabilir bir fikir, bir daha açmayacağınız hayali bir fikirden iyidir.
Peki ilk olarak hangi döngüyü ölçeceksiniz: kaydetmeyi, test çalıştırmasını ya da dağıtımı?