Ana Sayfa · Akademi · Tasarla ve Paylaş · Teknik İletişim ve Teknoloji İngilizcesi · Proje: İki Dilli Proje Tanıtımı ve README

Proje: İki Dilli Proje Tanıtımı ve README

Bu proje, aynı teknik çalışmayı Türkçe ve İngilizce okuyucu için doğal, kapsamı eşit ve terimleri tutarlı iki ayrı tanıtım metni ile README olarak hazırlar.

PROJE PUSULASI

Bu sayfayı ne için kullanacaksın?

Ana fikir

Bu proje, aynı teknik çalışmayı Türkçe ve İngilizce okuyucu için doğal, kapsamı eşit ve terimleri tutarlı iki ayrı tanıtım metni ile README olarak hazırlar

Üretilecek kanıt

Sayfanın uygulama görevini kendi girdin, test koşulun ve gerekçenle tamamla.

Kontrol tuzağı

Yaygın hata Neden sorun? Düzeltme kontrolü Makine çevirisini kontrolsüz yayımlamak İki dilde problem, çözüm, kurulum, test ve sınırlar aynı bilgi kapsamını taşır. Kapsam eşliği ilkesine dön; parite kontrolü. üret ve “Proje: İki Dilli Proje Tanıtımı ve README” kararını yeniden sınırla. Aynı terime sayfa içinde farklı…

Sonraki bağlantı

Kanıt dosyası ve revizyon notu tamamlandıktan sonra sıradaki içerik <strong>Teknik İletişim Quiz’i</strong>. Uygulama yapılmadıysa sayfa plan olarak kalır; tamamlanmış Doruk projesi gibi işaretlenmez.

Modül kaynakları: Plain Language Guidelines · W3C Writing for Web Accessibility

SeviyeBaşlangıç–Orta
Yaş10–15
Süre3–5 oturum
Ön koşulÖnceki ders önerilir
İçerikProje rehberi · 2108 kelime
Son güncelleme

Proje özeti

Bu proje, aynı teknik çalışmayı Türkçe ve İngilizce okuyucu için doğal, kapsamı eşit ve terimleri tutarlı iki ayrı tanıtım metni ile README olarak hazırlar. Bu bölümde noktayı özellikle “Proje özeti” bağlamına uygula ve sonucu doğrulayacak ya da değiştirecek kanıtı kaydet.

“Proje: İki Dilli Proje Tanıtımı ve README” bitmiş kişisel başarı iddiası değildir; uygulanabilir eğitim projesidir. Doruk’un çalışmayı gerçekten uyguladığına ilişkin belge, depo geçmişi, test kaydı ve veli/site yöneticisi onayı yoksa yalnız proje rehberi olarak kalır.

Neden bu proje?

Kelime kelime çeviri teknik anlamı bozabilir; yalnız İngilizce terimleri Türkçe cümlelere serpiştirmek de açıklık sağlamaz. İki dilde hedef kitle, terminoloji ve cümle yapısı ayrı editoryal kararla ele alınmalıdır.

Örnek başlangıç: Doruk’un Türkçe README’sindeki “kart” sözcüğü İngilizceye her yerde “card” çevriliyor; fakat bazı yerlerde “board”, bazı yerlerde “interface card” gerekir. Terim bağlamı çıkarılınca çeviri daha doğru oluyor.

Bu başlangıç sonucu önceden doğrulamaz. “Proje: İki Dilli Proje Tanıtımı ve README” projesi en sevilen metni veya ilk çalışan komutu haklı çıkarmak yerine okuyucu görevi, sürüm geçmişi, lisans ve doğrulama kanıtı üzerinden seçenekleri karşılaştırır.

Proje kazanımları

  • Kapsam eşliği
  • Terim tutarlılığı
  • Doğal uyarlama
  • Bağımsız okuma testi
  • Sürüm ve kanıt dosyası hazırlamak
  • Sınırlılık ile sonraki sürümü yazmak

Proje kararları

1. Kapsam eşliği

İki dilde problem, çözüm, kurulum, test ve sınırlar aynı bilgi kapsamını taşır. “Proje: İki Dilli Proje Tanıtımı ve README” içinde bu ilke, teknik bilginin yalnız doğru olmasını değil; hedef okuyucunun belgeyi izleyebilmesini, görevi yeniden yapabilmesini ve sınırları görebilmesini sağlar.

Konuya özel örnek: TR ve EN bölüm eşleştirme tablosu.

Beklenen kanıt: Parite kontrolü. “Proje: İki Dilli Proje Tanıtımı ve README” kanıtının tarihi, proje sürümü, kullanılan araç ve kontrol sonucu birlikte yazılır. Böylece başka bir öğrenci yalnız son dosyayı değil, kararın nasıl oluştuğunu da izleyebilir.

Sınır sorusu: “Proje: İki Dilli Proje Tanıtımı ve README” açısından okuyucu, ekip, araç, sürüm veya yayın ortamı değiştiğinde bu ilkenin hangi bölümü yeniden tanımlanmalıdır? Cevap mutlak bir kural yerine koşul, risk ve doğrulama yöntemi içermelidir.

2. Terim tutarlılığı

Ana teknik terimler sözlükte tek karşılık ve bağlam notuyla tutulur. “Proje: İki Dilli Proje Tanıtımı ve README” içinde bu ilke, teknik bilginin yalnız doğru olmasını değil; hedef okuyucunun belgeyi izleyebilmesini, görevi yeniden yapabilmesini ve sınırları görebilmesini sağlar.

Konuya özel örnek: branch = dal; ilk kullanımda Git bağlamı açıklanır.

Beklenen kanıt: Terim sözlüğü. “Proje: İki Dilli Proje Tanıtımı ve README” kanıtının tarihi, proje sürümü, kullanılan araç ve kontrol sonucu birlikte yazılır. Böylece başka bir öğrenci yalnız son dosyayı değil, kararın nasıl oluştuğunu da izleyebilir.

Sınır sorusu: “Proje: İki Dilli Proje Tanıtımı ve README” açısından okuyucu, ekip, araç, sürüm veya yayın ortamı değiştiğinde bu ilkenin hangi bölümü yeniden tanımlanmalıdır? Cevap mutlak bir kural yerine koşul, risk ve doğrulama yöntemi içermelidir. Bu bölümde noktayı özellikle “2. Terim tutarlılığı” bağlamına uygula ve sonucu doğrulayacak ya da değiştirecek kanıtı kaydet.

3. Doğal uyarlama

Cümleler hedef dilin anlatım düzenine göre yeniden yazılır; deyim ve belirsiz zamirler temizlenir. “Proje: İki Dilli Proje Tanıtımı ve README” içinde bu ilke, teknik bilginin yalnız doğru olmasını değil; hedef okuyucunun belgeyi izleyebilmesini, görevi yeniden yapabilmesini ve sınırları görebilmesini sağlar.

Konuya özel örnek: “Çalıştırmak” bağlama göre run, execute veya operate olabilir.

Beklenen kanıt: Editoryal karşılaştırma. “Proje: İki Dilli Proje Tanıtımı ve README” kanıtının tarihi, proje sürümü, kullanılan araç ve kontrol sonucu birlikte yazılır. Böylece başka bir öğrenci yalnız son dosyayı değil, kararın nasıl oluştuğunu da izleyebilir.

Sınır sorusu: “Proje: İki Dilli Proje Tanıtımı ve README” açısından okuyucu, ekip, araç, sürüm veya yayın ortamı değiştiğinde bu ilkenin hangi bölümü yeniden tanımlanmalıdır? Cevap mutlak bir kural yerine koşul, risk ve doğrulama yöntemi içermelidir. Bu bölümde noktayı özellikle “3. Doğal uyarlama” bağlamına uygula ve sonucu doğrulayacak ya da değiştirecek kanıtı kaydet.

4. Bağımsız okuma testi

Her dil sürümü o dili kullanan bir okuyucu tarafından tek başına anlaşılabilir olmalıdır. “Proje: İki Dilli Proje Tanıtımı ve README” içinde bu ilke, teknik bilginin yalnız doğru olmasını değil; hedef okuyucunun belgeyi izleyebilmesini, görevi yeniden yapabilmesini ve sınırları görebilmesini sağlar.

Konuya özel örnek: EN README yalnız TR sayfaya bağımlı değildir.

Beklenen kanıt: Dil bazlı test notu. “Proje: İki Dilli Proje Tanıtımı ve README” kanıtının tarihi, proje sürümü, kullanılan araç ve kontrol sonucu birlikte yazılır. Böylece başka bir öğrenci yalnız son dosyayı değil, kararın nasıl oluştuğunu da izleyebilir.

Sınır sorusu: “Proje: İki Dilli Proje Tanıtımı ve README” açısından okuyucu, ekip, araç, sürüm veya yayın ortamı değiştiğinde bu ilkenin hangi bölümü yeniden tanımlanmalıdır? Cevap mutlak bir kural yerine koşul, risk ve doğrulama yöntemi içermelidir. Bu bölümde noktayı özellikle “4. Bağımsız okuma testi” bağlamına uygula ve sonucu doğrulayacak ya da değiştirecek kanıtı kaydet.

Örnek proje akışı

Başlangıç vakası: Doruk’un Türkçe README’sindeki “kart” sözcüğü İngilizceye her yerde “card” çevriliyor; fakat bazı yerlerde “board”, bazı yerlerde “interface card” gerekir. Terim bağlamı çıkarılınca çeviri daha doğru oluyor.

Okuyucu ve amaç: İlk adımda belge biçimi seçilmez; kapsam eşliği ile terim tutarlılığı kararları yazılır. Okuyucunun bildiği, bilmesi gereken ve belge sonunda yapacağı görev ayrılır. Teknik ayrıntı ancak bu göreve hizmet ettiği ölçüde tutulur.

Belge mimarisi: “Çalıştırmak” bağlama göre run, execute veya operate olabilir. örneği tek başına yeterli sayılmaz. Başlık, özet, adımlar, görsel, doğrulama ve sınır bölümlerinin hangi soruyu cevapladığı belirtilir. Aynı bilgi birden fazla yerde tekrarlanıyorsa tek kaynak ve bağlantı düzeni kurulur.

Okuma ve yeniden üretim testi: “Proje: İki Dilli Proje Tanıtımı ve README” için Bağımsız okuma testi kullanılarak sonuç ölçülür. Yazarın “açık” bulduğu metin yerine, bağımsız okuyucunun görevi kaç adımda ve hangi hatalarla tamamladığı kaydedilir. Revizyon notu hangi cümle, tablo veya görselin hangi kanıt nedeniyle değiştiğini açıklar.

Karşı örnekle derinleştirme

“Proje: İki Dilli Proje Tanıtımı ve README” senaryosunda tek bir koşulu bilinçli olarak değiştir: hedef okuyucuyu başlangıç düzeyinden deneyimli kullanıcıya, aracı yerel dosyadan ortak depoya, metni tek dilden iki dile veya bireysel görevi takım çalışmasına çevir. Sonucun neden değişmesini beklediğini önce yaz; ardından aynı kanıt zincirini yeni koşulda sınamayı dene.

Tahminin tutmadığında başarısızlığı silme. “Proje: İki Dilli Proje Tanıtımı ve README” için hangi varsayımın yanlış olduğunu, hangi belgenin veya Git kaydının eksik kaldığını ve bir sonraki sürümde hangi kontrolün yapılacağını belirt. Böylece “Proje: İki Dilli Proje Tanıtımı ve README” ezberlenmiş bir tarif değil, farklı bağlamlarda sınanabilen bir karar sistemi olur.

Adım adım proje planı

1. Amaç ve güvenli çalışma alanı

Kelime kelime çeviri teknik anlamı bozabilir; yalnız İngilizce terimleri Türkçe cümlelere serpiştirmek de açıklık sağlamaz. İki dilde hedef kitle, terminoloji ve cümle yapısı ayrı editoryal kararla ele alınmalıdır. “Proje: İki Dilli Proje Tanıtımı ve README” projesinin bu aşaması tarihli belge, diff, commit, test tablosu, ekran görüntüsü veya karar notuyla kapanır; yalnız sözlü “tamamlandı” ifadesi kanıt sayılmaz.

2. Kapsam, roller ve yayın sınırı

İki dilde de kişisel veri ve yayın izinleri aynı dikkatle korunmalı; çeviri sırasında gizli bilginin yeni açıklama içine yanlışlıkla eklenmediği kontrol edilmelidir. “Proje: İki Dilli Proje Tanıtımı ve README” projesinin bu aşaması tarihli belge, diff, commit, test tablosu, ekran görüntüsü veya karar notuyla kapanır; yalnız sözlü “tamamlandı” ifadesi kanıt sayılmaz.

3. Başlangıç yapısı ve ilk kayıt

Kısa bir proje ve hedef okuyucu belirle. Türkçe ana metni problem–kurulum–test yapısıyla tamamla. “Proje: İki Dilli Proje Tanıtımı ve README” projesinin bu aşaması tarihli belge, diff, commit, test tablosu, ekran görüntüsü veya karar notuyla kapanır; yalnız sözlü “tamamlandı” ifadesi kanıt sayılmaz.

4. Uygulama ve ara kanıtlar

Teknik terimlerin iki dilli sözlüğünü çıkar. İngilizce sürümü kelime kelime değil bölüm amacıyla yeniden yaz. “Proje: İki Dilli Proje Tanıtımı ve README” projesinin bu aşaması tarihli belge, diff, commit, test tablosu, ekran görüntüsü veya karar notuyla kapanır; yalnız sözlü “tamamlandı” ifadesi kanıt sayılmaz.

5. Bağımsız test veya inceleme

Her dili ayrı okuyucuya kurulum göreviyle test ettir. “Proje: İki Dilli Proje Tanıtımı ve README” projesinin bu aşaması tarihli belge, diff, commit, test tablosu, ekran görüntüsü veya karar notuyla kapanır; yalnız sözlü “tamamlandı” ifadesi kanıt sayılmaz.

6. Revizyon, sürüm ve teslim

Farklılıkları parite raporunda açıkla. Aynı yaklaşım proje videosu altyazısı, poster, ders özeti ve uluslararası yarışma başvurusuna uygulanabilir. “Proje: İki Dilli Proje Tanıtımı ve README” projesinin bu aşaması tarihli belge, diff, commit, test tablosu, ekran görüntüsü veya karar notuyla kapanır; yalnız sözlü “tamamlandı” ifadesi kanıt sayılmaz.

  1. 1. adım: Kısa bir proje ve hedef okuyucu belirle.
  2. 2. adım: Türkçe ana metni problem–kurulum–test yapısıyla tamamla.
  3. 3. adım: Teknik terimlerin iki dilli sözlüğünü çıkar.
  4. 4. adım: İngilizce sürümü kelime kelime değil bölüm amacıyla yeniden yaz.
  5. 5. adım: Başlık, kod, görsel ve bağlantı paritesini kontrol et.
  6. 6. adım: Her dili ayrı okuyucuya kurulum göreviyle test ettir.
  7. 7. adım: Farklılıkları parite raporunda açıkla.
6. Revizyon, sürüm ve teslim tablosu
Karar alanıKontrol örneğiKanıtYorumlama ölçütü
Kapsam eşliğiTR ve EN bölüm eşleştirme tablosu.Parite kontrolü.İki dilde problem, çözüm, kurulum, test ve sınırlar aynı bilgi kapsamını taşır.
Terim tutarlılığıbranch = dal; ilk kullanımda Git bağlamı açıklanır.Terim sözlüğü.Ana teknik terimler sözlükte tek karşılık ve bağlam notuyla tutulur.
Doğal uyarlama“Çalıştırmak” bağlama göre run, execute veya operate olabilir.Editoryal karşılaştırma.Cümleler hedef dilin anlatım düzenine göre yeniden yazılır; deyim ve belirsiz zamirler temizlenir.
Bağımsız okuma testiEN README yalnız TR sayfaya bağımlı değildir.Dil bazlı test notu.Her dil sürümü o dili kullanan bir okuyucu tarafından tek başına anlaşılabilir olmalıdır.

Kanıt paketi: Türkçe ve İngilizce README, bölüm parite tablosu, iki dilli terim sözlüğü, bağımsız okuma testi ve yapılan editoryal değişiklik listesi saklanır.

Uygulama boyunca yalnız başarılı son ekran saklanmaz. Başlangıç durumu, hata belirtisi, karar gerekçesi, yapılan değişiklik ve yeniden kontrol sonucu yan yana tutulur. Böylece “Proje: İki Dilli Proje Tanıtımı ve README” estetik tercih veya ezberlenmiş komut değil, başkası tarafından incelenebilir bir çalışma olur.

Belgeleme kaydı: “Proje: İki Dilli Proje Tanıtımı ve README” için hedef okuyucu, belge sürümü, kullanılan kaynaklar, test edilen adımlar ve bağımsız okuma sonucu ayrı yazılır. Yalnız güzel görünen son belge, yeniden üretim kanıtı sayılmaz.

Aktarım görevi: Aynı yaklaşım proje videosu altyazısı, poster, ders özeti ve uluslararası yarışma başvurusuna uygulanabilir. “Proje: İki Dilli Proje Tanıtımı ve README” bilgisini yeni bağlama taşırken hedef okuyucu, takım yapısı, araç sürümü, lisans ve mahremiyet sınırlarını yeniden yazmadan eski şablonu körlemesine kopyalama.

Proje riskleri ve sık hatalar

Proje riskleri ve sık hatalar tablosu
Yaygın hataNeden sorun?Düzeltme kontrolü
Makine çevirisini kontrolsüz yayımlamakİki dilde problem, çözüm, kurulum, test ve sınırlar aynı bilgi kapsamını taşır.Kapsam eşliği ilkesine dön; parite kontrolü. üret ve “Proje: İki Dilli Proje Tanıtımı ve README” kararını yeniden sınırla.
Aynı terime sayfa içinde farklı karşılık vermekAna teknik terimler sözlükte tek karşılık ve bağlam notuyla tutulur.Terim tutarlılığı ilkesine dön; terim sözlüğü. üret ve “Proje: İki Dilli Proje Tanıtımı ve README” kararını yeniden sınırla.
İngilizce sürümde bölüm atlamakCümleler hedef dilin anlatım düzenine göre yeniden yazılır; deyim ve belirsiz zamirler temizlenir.Doğal uyarlama ilkesine dön; editoryal karşılaştırma. üret ve “Proje: İki Dilli Proje Tanıtımı ve README” kararını yeniden sınırla.
Bir dili diğerine bağımlı bırakmakHer dil sürümü o dili kullanan bir okuyucu tarafından tek başına anlaşılabilir olmalıdır.Bağımsız okuma testi ilkesine dön; dil bazlı test notu. üret ve “Proje: İki Dilli Proje Tanıtımı ve README” kararını yeniden sınırla.

“Proje: İki Dilli Proje Tanıtımı ve README” sırasında başarısız kurulum, eksik belge, yanlış commit, lisans uyumsuzluğu veya anlaşılmayan adım saklanmaz. Bu bulgu sonraki sürümün hedefini oluşturur; yalnızca sorunsuz görünen ekranı veya son dosyayı seçmek proje güvenilirliğini azaltır.

Güvenlik ve yayın sınırı

İki dilde de kişisel veri ve yayın izinleri aynı dikkatle korunmalı; çeviri sırasında gizli bilginin yeni açıklama içine yanlışlıkla eklenmediği kontrol edilmelidir.

<strong>Proje kanıt paketi:</strong> Türkçe ve İngilizce README, bölüm parite tablosu, iki dilli terim sözlüğü, bağımsız okuma testi ve yapılan editoryal değişiklik listesi saklanır.

“Proje: İki Dilli Proje Tanıtımı ve README” uygulaması yayımlanacaksa hesap adı, okul bilgisi, gerçek konum, özel depo, anahtar ve üçüncü kişilere ait içerik açık izin olmadan paylaşılmaz.

Teslim ölçütleri

Proje yalnız son çıktı ile tamamlanmış sayılmaz. “Proje: İki Dilli Proje Tanıtımı ve README” tesliminde amaç, kapsam, kaynak, sürüm, değişiklik gerekçesi, test sonucu, hata kaydı ve bir sonraki adım birlikte bulunmalıdır.

Aynı yaklaşım proje videosu altyazısı, poster, ders özeti ve uluslararası yarışma başvurusuna uygulanabilir.

Proje kontrol soruları

  1. “Proje: İki Dilli Proje Tanıtımı ve README” konusunun temel amacı nedir?
  2. Kapsam eşliği neden ilk adımda açıkça yazılmalıdır?
  3. “Proje: İki Dilli Proje Tanıtımı ve README” senaryosunda hangi kanıt ilk varsayımı sınar?
  4. “Proje: İki Dilli Proje Tanıtımı ve README” çalışmasında hangi hata sonucu yanıltabilir?
  5. “Proje: İki Dilli Proje Tanıtımı ve README” için güvenlik veya mahremiyet sınırı nedir?
  6. “Proje: İki Dilli Proje Tanıtımı ve README” bilgisi başka bir projeye nasıl aktarılır?

Açıklamalı cevaplar

  1. Bu proje, aynı teknik çalışmayı Türkçe ve İngilizce okuyucu için doğal, kapsamı eşit ve terimleri tutarlı iki ayrı tanıtım metni ile README olarak hazırlar.
  2. İki dilde problem, çözüm, kurulum, test ve sınırlar aynı bilgi kapsamını taşır. Bu nedenle parite kontrolü. hazırlanır ve karar yalnız kişisel yoruma bırakılmaz.
  3. Doruk’un Türkçe README’sindeki “kart” sözcüğü İngilizceye her yerde “card” çevriliyor; fakat bazı yerlerde “board”, bazı yerlerde “interface card” gerekir. Terim bağlamı çıkarılınca çeviri daha doğru oluyor. durumunda terim tutarlılığı ile ilişkili terim sözlüğü. ilk varsayımı görünür kılar.
  4. Makine çevirisini kontrolsüz yayımlamak. Düzeltmek için doğal uyarlama ilkesine dönülür ve editoryal karşılaştırma. üretilir.
  5. İki dilde de kişisel veri ve yayın izinleri aynı dikkatle korunmalı; çeviri sırasında gizli bilginin yeni açıklama içine yanlışlıkla eklenmediği kontrol edilmelidir.
  6. Aynı yaklaşım proje videosu altyazısı, poster, ders özeti ve uluslararası yarışma başvurusuna uygulanabilir.

Kaynak ve doğrulama notları

“Proje: İki Dilli Proje Tanıtımı ve README” projesi aşağıdaki resmî veya birincil kaynaklarla temellendirilmiştir. Git, GitHub, dokümantasyon aracı veya lisans metni zamanla değişebileceği için proje tarihinde kullanılan gerçek sürüm ve koşullar ayrıca kaydedilmelidir.

Sonraki adım

Kanıt dosyası ve revizyon notu tamamlandıktan sonra sıradaki içerik <strong>Teknik İletişim Quiz’i</strong>. Uygulama yapılmadıysa sayfa plan olarak kalır; tamamlanmış Doruk projesi gibi işaretlenmez.

SORU HAVUZU

Bu dersi 10 soruyla pekiştir

Bu ders için 24 soruluk bir havuz hazırlandı. Her başlangıçta 10 soru ve seçenek sıraları yeniden seçilir; sonuçlar yalnız bu tarayıcıda kalır.