Bu sayfa, Google Dokümanlar Sezonu için kabul edilen bir teknik yazı projesinin ayrıntılarını içerir.
Proje özeti
- Açık kaynak kuruluşu:
- En önemli
- Teknik yazar:
- @anindita_basu
- Projenin adı:
- Ürün İçi Metni İnceleyin ve Hassaslaştırın
- Proje süresi:
- Uzun süreli (5 ay)
Proje açıklaması
Slack kanalına katıldım ve Eren'e bazı sorular yönelttim. Verdiği yanıta dayanarak
(teşekkür ederiz Erol!), Bu projeye
şekilde yaklaşmayı öneriyorum:
Dizeleri sınıflandırma
İlk olarak, hangi dizelerin (https://github.com/mattermost/mattermost-webapp/blob/master/i18n/en.json) sistem konsolu olduğunu ve hangilerinin kullanıcılara yönelik olduğunu belirleyerek başlayacağım. Öncelikle kullanıcılara yönelik dizeleri inceleme için almanızı öneriyorum.
Dizeler için bir stil kılavuzu oluşturma
Menü öğeleri, işlem düğmeleri, etiketler, başlıklar, ipuçları, hatalar, uyarılar, doğrulamalar, bildirimler ve onaylarda kullanılan dizeler için büyük harf kullanımı, uzunluk ve kelime kullanımı stilini tanımlamak istiyorum (https://github.com/AninditaBasu/AninditaBasu.github.io/blob/master/gsod/Capture7.PNG adresinde örnek bir stil kılavuzu ekran görüntüsüne bakın). Ayrıca, dizelerde, özellikle de birleşik dizelerde jetonların (yer tutucuların) kullanımıyla ilgili bazı bilgiler sunmak istiyorum.
Bu kılavuzu, A4 boyutundaki sayfalarda tek bir sayfada ve mümkünse daha kısa olacak şekilde sunmayı hedefliyoruz. Bu dizeleri yazan geliştiriciler, kılavuzu hızlı ve kolay bir şekilde bulmalı ve takip edildiğinde kullanıcı arayüzü metni tüm ekranlarda tutarlılık gösterecek.
Bunu iki nedenden dolayı öneriyoruz: (a) dil bilgisi ve stil açısından metinde tutarlılık sağlamak (b) Böylece GSoD sona erdikten sonra bile, kullanıcı arayüzü metni yazarken herkesin hızlı bir şekilde başvurabileceği bir dizi talimat olması.
Metni inceleyin ve ayrıntılandırın
#2'de oluşturulan stil kılavuzuna göre, GitHub'da dizeleri düzenleyecek ve pull istekleri oluşturacağım.
=============
Süre
Dizelerden kaç tanesinin kullanıcılara yönelik dize olduğunu henüz bilmiyorum (bu projede incelenmeyi teklif ettiğim dize buydu). Stil kılavuzunun oluşturulmasının yaklaşık 3 hafta süreceğini tahmin ediyorum (taslaktan onaya kadar) ve bu çalışma, dizeleri sistem dizeleri veya kullanıcıya yönelik olarak sınıflandırarak eş zamanlı olarak yapılabilir. Projenin standart uzunluktaki (3 ay) bir proje olacağını varsayarak başlamayı öneriyorum. Bu süre içinde mümkün olduğunca çok sayıda dizeyi gözden geçirmek için kullanıyorum.
Zaten tam zamanlı çalıştığım için bu projede günün yalnızca bir kısmında çalışabilirim. Azalan çalışma saatlerimin de ihtiyaç duyduğunu düşünüyorsanız daha uzun süreli bir proje fikrine açığım.