Ana sayfa › Blog › Sektörel İngilizce
Yazılımcılar İçin İngilizce: Code Review, Dokümantasyon ve Stand-up Dili
· 9 dk okuma · Sektörel İngilizce
Yazılımcılar için İngilizce rehberi: stand-up cümleleri, kod incelemesinde nazik eleştiri kalıpları, PR açıklaması ve dokümantasyon dili örnek tabloyla.
Yazılımcılar için İngilizce, ders kitabı İngilizcesinden farklı olarak üç dar alanda yoğunlaşır: günlük toplantıda ne yaptığını anlatmak, kod incelemesinde eleştiriyi kırmadan iletmek ve yazdığın şeyi başkasının anlayacağı biçimde belgelemek. Çoğu yazılımcı okuyup yazabilir ama konuşurken tıkanır; bunun nedeni gramer değil, hazır cümle eksikliğidir. Aşağıda üç alanın da kalıpları var.
Stand-up: üç cümlelik bir format
Günlük toplantı, İngilizcesi zayıf olduğunu düşünen geliştiriciler için en çok gerilim yaratan an. Oysa stand-up neredeyse sabit bir şablondur: dün ne yaptın, bugün ne yapacaksın, engel var mı. Bu şablonu öğrendiğinizde toplantı, doğaçlama olmaktan çıkar.
Yesterday I finished the validation layer and opened a pull request. Today I am going to work on the retry logic. No blockers. Üç cümle. Detay isteyen olursa açarsınız, istemiyorsa toplantı akar.
Engel bildirirken suçlayıcı olmayan bir kalıp kullanın: I am blocked on the staging credentials. Could someone point me to the right person? Bu yapı sorunu bildirir, kimseyi işaret etmez ve somut bir talep içerir.
Code review: eleştiriyi yumuşatan yapılar
Kod incelemesinde en sık yapılan dil hatası, yorumu doğrudan emir olarak yazmaktır. Change this teknik olarak doğrudur ama yazılı ortamda sert okunur, çünkü yazıda ses tonu yoktur. Aynı isteği soru veya öneri hâline getirmek, aynı işi gerginlik yaratmadan yapar.
Yorumun yanına gerekçe eklemek ikinci kuraldır. I would rename this ile I would rename this, because it is easy to confuse with the other user object arasındaki fark, tartışma süresini yarıya indirir.
| Sert duran ifade | Daha iyi karşılığı | Türkçe anlamı |
|---|---|---|
| This is wrong. | I think there may be an issue here — what do you think? | Burada bir sorun olabilir gibi görünüyor, ne dersin? |
| Change this to a map. | Would it make sense to use a map here? | Burada map kullanmak mantıklı olur mu? |
| You forgot the tests. | Are we planning to add tests for this part? | Bu kısım için test eklemeyi düşünüyor muyuz? |
| I do not understand. | Could you walk me through this part? | Bu kısmı biraz açabilir misin? |
| Bad naming. | Minor: maybe a clearer name would help future readers. | Küçük bir not: daha açık bir isim ileride okuyanlara yardımcı olur. |
| No. | I see it differently — here is my concern. | Ben farklı görüyorum, endişem şu. |
Yorumun önemini işaretlemek, incelemeyi hızlandıran küçük bir alışkanlıktır. nit: (önemsiz), question: (soru), blocking: (birleştirmeden önce çözülmeli) etiketleri yaygın olarak kullanılır ve karşı tarafın neye öncelik vereceğini netleştirir.
Pull request ve commit metinleri
PR açıklaması üç soruyu cevaplamalıdır: ne değişti, neden değişti, nasıl test edilir. Uzun anlatım yerine kısa başlıklar kullanın. This PR adds retry handling to the payment client. Without it, a single timeout fails the whole batch. Tested locally with the mock server and on staging.
Commit mesajlarında emir kipi standarttır: Add retry handling, Fix null check in parser, Remove unused import. Geçmiş zaman (added, fixed) da görülür ama bir projede tek biçim seçilip ona sadık kalınması beklenir.
İnceleme isterken net olun: Could you take a look when you have time? It is not urgent. Aciliyeti belirtmek, dağıtık ekiplerde en çok teşekkür alan davranışlardan biridir.
Dokümantasyon: sade ve tahmin edilebilir dil
İyi teknik dokümantasyon, süslü değil öngörülebilir olandır. Adımları emir kipiyle yazın: Install the dependencies. Run the migration. Restart the service. Davranış anlatırken geniş zaman kullanın: The endpoint returns 404 if the record does not exist.
Belirsiz ifadelerden kaçının. It should work veya usually gibi kelimeler okuyanı ikinci bir soruya iter. Koşulu yazın: If the token has expired, the request fails with a 401.
- Uyarı: Note that this operation cannot be undone.
- Önkoşul: Before you start, make sure you have access to the staging database.
- Varsayılan: By default, the timeout is set to thirty seconds.
- İsteğe bağlı: Optionally, you can pass a custom config file.
- Bilinen sorun: This is a known limitation and will be addressed later.
Toplantı, olay yönetimi ve tartışma
Teknik tartışmada anlaşmazlığı ifade etmek en çok zorlanılan kısımdır. Karşı çıkarken önce ortak zemini söyleyin: I agree with the goal, but I am worried about the migration cost. Bu yapı fikri savunur, kişiyi hedef almaz.
Olay anında dil daha da kısalır ve durum bildirimi standartlaşır: We are seeing elevated error rates on the checkout service. I am investigating. I will update in fifteen minutes. Üç cümle; durum, kim bakıyor, bir sonraki güncelleme ne zaman.
Anlamadığınız bir şeyi sormak, teknik ekiplerde zayıflık değil beklenen davranıştır: Sorry, I missed that — could you repeat the part about the queue? Mühendislik tarafında benzer bir netlik ihtiyacı için mühendisler için İngilizce yazısına, mülakat ve geri bildirim tarafı için insan kaynakları İngilizcesi yazısına bakabilirsiniz.
Yabancı ekip arkadaşıyla günlük yazışma
Dağıtık ekiplerde işin büyük kısmı yazılı kanallarda döner ve orada iki şey belirleyicidir: bağlam ve talep. Bağlam olmadan atılan mesaj, karşı tarafı geçmişi okumaya zorlar. Quick context: the payment job failed twice last night. I think it is the new timeout. Could you check the queue config when you get a chance? Üç cümle, tam bir istek.
Zaman dilimi farkı varsa aciliyeti açıkça yazın: No rush, tomorrow morning your time is fine. Bu cümle karşı tarafın mesai dışında kendini baskı altında hissetmesini engeller ve uzaktan çalışan ekiplerde alışkanlık hâline gelmiştir.
Bir işi devrederken durumun nerede kaldığını yazın: I have pushed what I have so far. The parser works, but the error handling is not done yet. Yarım bırakılan işin dili, tamamlanan işin dilinden daha önemlidir, çünkü devralan kişi tahmin yürütmek zorunda kalmamalıdır.
Yazılımcılar için İngilizcede sık yapılan hatalar
Mükemmel cümle beklemek. Toplantıda doğru ama basit bir cümle, kafanızda kurduğunuz karmaşık cümleden her zaman daha iyidir. Sessiz kalmanın maliyeti hatadan yüksektir.
Yazılı tonu kontrol etmemek. Kısa yazılmış bir yorum, farklı kültürlerde sert algılanabilir. Bir soru işareti veya kısa bir gerekçe, tonu yeterince yumuşatır.
Terim yığmak. Cümlenin tamamını terimle doldurmak anlaşılırlığı düşürür. Terim kalsın, etrafındaki cümle sade olsun.
Özet: az cümle, çok tekrar
Yazılımcılar için İngilizcede yol, gramer kitabından değil; stand-up, code review, PR ve dokümantasyon olmak üzere dört akışın hazır cümlelerinden geçer. Bu cümleleri yazarak değil, sesli tekrar ederek refleks hâline getirmek gerekir. English Talky Cafe masalarında üç-dört kişilik gruplarda konuşuluyor; TalkyTech AI soruyu açıyor, söz sırasını dağıtıyor ve masa sonunda kişisel geri bildirim veriyor, konuşma sırasında araya girip düzeltme yapılmıyor. Toplantıda tıkanmamak için masaya katılın.
Sık sorulan sorular
Kod yazabiliyorum ama toplantıda konuşamıyorum, neden?
Code review yorumlarım sert mi algılanıyor?
Dokümantasyonda hangi zaman kullanılır?
Teknik terimleri Türkçeleştirmeli miyim?
Okumak yetmez — konuşmak gerekir
English Talky Cafe masalarında 3–4 kişilik gruplarla konuşun, masa sonunda size özel geri bildirim alın.
Bir masaya katıl