Technical English: Anlaşılmak, Sadece Duyulmak Değil

İş yerindeki çoğu teknik yanlış anlaşılmanın dilbilgisiyle hiçbir ilgisi yoktur. Bir ticket yanlış okunur, bir Slack mesajı göz ardı edilir, bir standup güncellemesi herkesin aslında ne olduğunu anlamasını sarsar. Eğer güvenlik veya geliştirme ekiplerinde bir düzine farklı ülkeden gelen insanlarla zaman harcadıysanız, zaten gerçek becerinin akıcılık değil — zaman baskısı altında kesinlik olduğunu biliyorsunuz.

Neden dilbilgisi darboğaz değildir

Ana dili konuşmacuları sürekli kafa karıştırıcı ticketlar yazarlar. Sorun genellikle kelime dağarcığı değil, yapıdır. "API yine garip davranıyor, dün o şeyden kaynaklanabilir" gibi bir mesaj, aksene veya dilbilgisi puanına bakılmaksızın başarısız olur. Bunu şu ile karşılaştırın: "POST /users/create 14:02 UTC'den beri 500 döndürüyor. Dün ki deploy'dan sonra başladı (commit a3f9c1). Loglar ekte." Bu ikinci versiyon işe yarar çünkü olguyu öne koyar, bir zaman damgası verir ve şüphelenilen nedeni adlandırır. Bunu okuyan herkes, herhangi bir saat diliminde, sırada ne gelecek olduğunu bilir.

Bu, dağıtık ve güvenlik ekiplerinde diğer hemen hemen her yerde olduğundan daha önemlidir. Saat 3'te açılan bir olay müdahale kanalında belirsiz dil veya uzun hazırlık cümlelerine yer yoktur. İngilizce ana diliniz değilse burada bir avantajınız vardır: zaten söylemeden önce aslında ne söylemek istediğinizi düşünmeye zorluyorsunuz. Ana dili konuşmacuları sık sık bu adımı atlarlar ve konuşurlar.

İş yazınının %90'ını kapsayan üç cümle şekli

Çoğu teknik iletişim üç desene uyar:

1. Durum + delil — "Giriş endpoint'i aralıklı olarak başarısız oluyor. Son bir saatteki hata oranı %3, hepsi 502, hepsi us-east-1'den."
2. Sor + kısıtlama — "Deploy'dan önce saat 16:00'ye kadar firewall kuralı değişikliğini gözden geçirebilir misin? Deploy'u engelliyorsunuz."
3. Karar + neden — "v2.3.1'e geri döndürüyoruz. Yeni rate limiter yasal trafiği düşürüyor."

Bu şekilleri ezbere bilirseniz, standup, ticket veya postmortem'in ihtiyaç duyduğu hemen hemen her şeyi süslü kelime dağarcığına başvurmadan yazabilirsiniz. Süslü kelime dağarcığı genellikle yerli olmayan konuşmacıların zaman ve özgüveni kaybettikleri yerdir — bulunmaya çalışılır