Small fix to en and Turkish (tr_TR) translations
This commit is contained in:
Emre Erkan
parent
9d8ef43fa4
commit
792791f9e8
|
|
@ -51,7 +51,7 @@ version: 1.0.0
|
|||
|
||||
%p
|
||||
People do. Whether consumers or developers, the end users of
|
||||
software are human beings who care about what's in the sofware. When
|
||||
software are human beings who care about what's in the software. When
|
||||
the software changes, people want to know why and how.
|
||||
|
||||
.good-practices
|
||||
|
|
|
|||
|
|
@ -0,0 +1,311 @@
|
|||
---
|
||||
description: Değişiklik kaydı tutun
|
||||
title: Değişiklik kaydı tutun
|
||||
language: tr
|
||||
version: 1.0.0
|
||||
---
|
||||
|
||||
- changelog = "https://github.com/olivierlacan/keep-a-changelog/blob/master/CHANGELOG.md"
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
- ghr = "https://help.github.com/articles/creating-releases/"
|
||||
|
||||
.header
|
||||
.title
|
||||
%h1 Değişiklik kayıtları tutun
|
||||
%h2 Arkadaşlarınızın, git mesajlarını değişiklik kayıtlarına yığmasını engelleyin.
|
||||
|
||||
= link_to changelog do
|
||||
Version
|
||||
%strong= current_page.metadata[:page][:version]
|
||||
|
||||
%pre.changelog= File.read("CHANGELOG.md")
|
||||
|
||||
.answers
|
||||
%h3#what
|
||||
%a.anchor{ href: "#what", aria_hidden: "true" }
|
||||
Nedir bu değişiklik kayıtları?
|
||||
|
||||
%p
|
||||
Değişiklik kayıtları bir proje için özel olarak hazırlanmış,
|
||||
tarihsel sıralamayla sıralanmış, önemli değişikliklerin bir bütünüdür.
|
||||
|
||||
%h3#why
|
||||
%a.anchor{ href: "#why", aria_hidden: "true" }
|
||||
Değişikliklerin kayıtlarını tutmanın anlamı ne?
|
||||
|
||||
%p
|
||||
Bir projenin kullanıcılarının ya da katılımcılarının, dağıtımlar
|
||||
(ya da sürümler) arasındaki tam olarak hangi önemli değişikliklerin
|
||||
olduğunu takip edebilmelerini sağlar.
|
||||
|
||||
%h3#who
|
||||
%a.anchor{ href: "#who", aria_hidden: "true" }
|
||||
Kim değişiklik kayıtlarına ihtiyaç duyar ki?
|
||||
|
||||
%p
|
||||
İnsanlar. İster tüketici olsun, ister geliştirici, kullanılan yazılımın
|
||||
son kullanıcıları, o yazılımın içinde ne olduğunu önemseyen kişilerdir.
|
||||
Yazılım değiştiğinde, insanlar neden ve nasıl olduğunu bilmek isterler.
|
||||
|
||||
.good-practices
|
||||
%h3#how
|
||||
%a.anchor{ href: "#how", aria_hidden: "true" }
|
||||
Nası iyi değişiklik kayıtları tutarım?
|
||||
|
||||
%h4#principles
|
||||
%a.anchor{ href: "#principles", aria_hidden: "true" }
|
||||
Rehber prensipler
|
||||
|
||||
%ul
|
||||
%li
|
||||
Değişiklik kayıtları <em>insanlar</em> içindir, makineler için dğeil.
|
||||
%li
|
||||
Her sürüm için bir girdi içermelidir.
|
||||
%li
|
||||
Benzer değişiklikler gruplanmalıdır.
|
||||
%li
|
||||
SÜrümler ve bölümlere bağlantı verilebilir olmalıdır.
|
||||
%li
|
||||
En son sürüm ilk başta olur.
|
||||
%li
|
||||
Her sürümün dağıtım tarihi bulunmalıdır.
|
||||
%li
|
||||
Geliştirirken #{link_to "Anlamlı sürümlendirme", semver} kullanıp kullanmadığınızı bildirin.
|
||||
|
||||
%a.anchor{ href: "#types", aria_hidden: "true" }
|
||||
%h4#types Değişiklik tipleri
|
||||
|
||||
%ul
|
||||
%li
|
||||
%code Eklendi
|
||||
\: Yeni özellikler için.
|
||||
%li
|
||||
%code Değişti
|
||||
\: Var olan becerilerde yapılan değişiklikler için.
|
||||
%li
|
||||
%code Rafa kalktı
|
||||
\: Gelecekte yok olacak beceriler için.
|
||||
%li
|
||||
%code Kaldırıldı
|
||||
\: Kaldırılan beceriler için.
|
||||
%li
|
||||
%code Düzeltildi
|
||||
\: Ayıklanmış hatalar için.
|
||||
%li
|
||||
%code Güvenlik
|
||||
\: Bir güvenlik açığı söz konusuysa.
|
||||
|
||||
.effort
|
||||
|
||||
%h3#effort
|
||||
%a.anchor{ href: "#effort", aria_hidden: "true" }
|
||||
Gerekli çabayı nasıl en aza indirebilirim?
|
||||
|
||||
%p
|
||||
Her zaman en üstte, değişiklikleri takip ettiğiniz bir <code>Yayımlanmadı</code>
|
||||
bölümü olsun
|
||||
|
||||
%p Bu, iki amaca hizmet eder:
|
||||
|
||||
%ul
|
||||
%li
|
||||
İnsanlar gelecek sürümlerde karşılarına ne gibi değişiklikler çıkacağını görebilirler
|
||||
%li
|
||||
Dağıtım zamanı geldiğinde <code>Yayımlanmadı</code> bölümünü
|
||||
yeni dağıtım sürümü bölümü olarak kullanabilirsiniz.
|
||||
|
||||
.bad-practices
|
||||
%h3#bad-practices
|
||||
%a.anchor{ href: "#bad-practices", aria_hidden: "true" }
|
||||
Değişiklik kütükleri kötü olabilirler mi?
|
||||
|
||||
%p Evet. Buyrun size işe yaramayacak bir kaç örnek.
|
||||
|
||||
%h4#log-diffs
|
||||
%a.anchor{ href: "#log-diffs", aria_hidden: "true" }
|
||||
Commit kayıtlarının farkları
|
||||
|
||||
%p
|
||||
Değişiklik kayıtları için commit kayıtlarının farklarını kullanmak
|
||||
kötü bir fikirdir: genellikle çok gürültülü olurlar. Commit birleşmeleri,
|
||||
kötü başlıklı commitler, belgeleme değişiklikleri vb.
|
||||
|
||||
%p
|
||||
Bir commit yapılmasının sebebi, kodun bir sonraki aşamaya evrilmesidir.
|
||||
Bazı projeler commitleri temizler, bazıları temizlemez.
|
||||
|
||||
%p
|
||||
Değişiklik kayıtlarına eklenen bir girdi ise, öneme sahip bir değişikliğin
|
||||
belgelenmesi amaçlıdır. Genelde bir çok commit işlemini kapsar ve son
|
||||
kullanıcıyla iletişimi açık tutar.
|
||||
|
||||
%h4#ignoring-deprecations
|
||||
%a.anchor{ href: "#ignoring-deprecations", aria_hidden: "true" }
|
||||
Rafa kalkanları göz ardı etmek
|
||||
|
||||
%p
|
||||
İnsanlar bir sürümden diğerine yükselttiklerinde, bir şeylerin bozulup
|
||||
bozulmayacağı acı verici derecede açık olmalıdır. Rafa kalkan özelliklerin
|
||||
listelendiği, sonra bu rafa kaldırılanlara yönelik kendi geliştirmelerini
|
||||
yapabileceği ve sonrasında da özelliklerin tamamen kaldırıldığı sürüme
|
||||
geçiş yapabilmeliler.
|
||||
|
||||
%p
|
||||
Eğer hiç bir şey yapmasanız bile, rafa kalkanlaı, kaldırılanları ve
|
||||
önemli değişiklikleri değişiklik kayıtlarınızda listeleyin.
|
||||
|
||||
|
||||
%h4#confusing-dates
|
||||
%a.anchor{ href: "#confusing-dates", aria_hidden: "true" }
|
||||
Kafa karıştırıcı tarihler
|
||||
|
||||
%p
|
||||
A.B.D.'de insanlar ay kısmını önce kullanırken (2 Haziran 2012 için
|
||||
<code>06-02-2012</code>), dünyanın bir çok bölümünde daha robotik bir
|
||||
kullanım <code>2 Haizran 2012</code> söz konusu. <code>2012-06-02</code>
|
||||
biçimi en küçüğünden en büyüğüne tüm biçimlerle çalışmadan kullanılabiliyor
|
||||
ve #{link_to "ISO standardı", iso}. Bu sebeple değişiklik kayıtlaro için
|
||||
önerilen tarih biçimidir.
|
||||
|
||||
%aside
|
||||
Dahası da var. Bu karşıt desenleri toplamam için
|
||||
= link_to "bir çağrı açın", "#issues"
|
||||
ua da bir çekme isteği gönderin.
|
||||
|
||||
.frequently-asked-questions
|
||||
%h3#frequently-asked-questions
|
||||
%a.anchor{ href: "#frequently-asked-questions", aria_hidden: "true" }
|
||||
Sıkça sorulan sorular
|
||||
|
||||
%h4#standard
|
||||
%a.anchor{ href: "#standard", aria_hidden: "true" }
|
||||
Standart bir değişiklik kayıt biçimi var mı?
|
||||
|
||||
%p
|
||||
Pek sayılmaz. GNU değişiklik kayıtları sil rehberi mevcut ya da
|
||||
iki paragraf GNU NEWS dosyası "guideline" var. İkisi de uygun
|
||||
değiller ve yetersizler.
|
||||
|
||||
%p
|
||||
Bu proje daha iyi
|
||||
= link_to "bir değişiklik kayıtları düzeni.", changelog
|
||||
oluşturmaya çalışıyor. Bunun için de açık kaynaklı topluluklardaki,
|
||||
en iyi kullanımları inceleyip, topluyoruz.
|
||||
|
||||
%p
|
||||
Sağlıklı eleştiriler, tartışmalar ve öneriler, projenin gelişmesi
|
||||
için her zaman
|
||||
= link_to "hoş karşılanır.", issues
|
||||
|
||||
|
||||
%h4#filename
|
||||
%a.anchor{ href: "#filename", aria_hidden: "true" }
|
||||
Değişiklik kayıtları dosyasının ismi ne olmalı?
|
||||
|
||||
%p
|
||||
İsterseniz <code>CHANGELOG.md</code> olarak isimlendirin. Bazı projeler
|
||||
<code>HISTORY</code>, <code>NEWS</code> ya da <code>RELEASES</code>
|
||||
kullanıyor.
|
||||
|
||||
%p
|
||||
Dosya isminin çok da önemli olmadığını düşünebilirsiniz, fakat
|
||||
nedne kullanıcılarınızın değişiklikleri taki edebilmesi için
|
||||
onların işlerini zorlaştırasınız ki?
|
||||
|
||||
%h4#github-releases
|
||||
%a.anchor{ href: "#github-releases", aria_hidden: "true" }
|
||||
GitHub dağıtımları ne olacak?
|
||||
|
||||
%p
|
||||
Harika bir girişim. #{link_to "Dağıtımlar", ghr} içine kendiniz
|
||||
değişiklik kayıtları eklerseniz basit git etiketlerini
|
||||
(örneğin <code>v1.0.0</code>) zengin dağıtım notlarına çevirebilir
|
||||
ya da notlar eklenmiş git etiketlerinden oluşturulabilirsiniz.
|
||||
|
||||
%p
|
||||
GtHub dağıtımları sadece GitHub içeriğinde görüntülenebilecek,
|
||||
taşınamaz değişiklik kayıtları oluşturur. Biraz emek harcayarak
|
||||
"Keep a Changelog" biçimine uygun hale getirilebilir.
|
||||
|
||||
%p
|
||||
Ayrıca GitHub dağıtımlarının şu anki hali son kullanıcılar tarafından
|
||||
çok kolay bulunabilir değil. Tipik büyük harfli dosyalar
|
||||
(<code>README</code>, <code>CONTRIBUTING</code>, vb.) daha çok göze
|
||||
çarpıyor. Bir başka konu da mevcut arayüz her dağıtım arasındaki
|
||||
commit kayıtlarına bağlantı vermeye izin vermiyor..
|
||||
|
||||
%h4#automatic
|
||||
%a.anchor{ href: "#automatic", aria_hidden: "true" }
|
||||
Değişiklik kayıtları otomatik olarak toplanabilir mi?
|
||||
|
||||
%p
|
||||
Zor, çünkü insanlar bir çok farklı biçim ve dosya isimleri
|
||||
kullanıyorlar.
|
||||
|
||||
%p
|
||||
#{link_to "Vandamme", vandamme}, #{link_to "Gemnasium", gemnasium}
|
||||
ekibi tarafından oluşturulmuş bir Ruby Gem'i ve bir çok (ama hepsi
|
||||
değil) açık kaynak projenin değişiklik kayıtlarını okuyabiliyor.
|
||||
|
||||
|
||||
%h4#yanked
|
||||
%a.anchor{ href: "#yanked", aria_hidden: "true" }
|
||||
Peki ya Geri çekilen dağıtımlar?
|
||||
|
||||
%p
|
||||
Geri çekilen dağıtımlar, önemli hatalar ya da güvenlik sebepleri nedeniyle
|
||||
yayından geri çekilen sürümlerdir. Genelde bu sürümler değişiklik kayıtlarında
|
||||
görüntülenmezler. Görünmeliler. Tam da şu şekilde görünmeliler:
|
||||
|
||||
%p <code>## 0.0.5 - 2014-12-13 [GERİ ÇEKİLDİ]</code>
|
||||
|
||||
%p
|
||||
<code>[GERİ ÇEKİLDİ]</code> etiketi belirli bir sebepten büyük harf.
|
||||
İnsanların bunu fark etmeleri çok önemli. Ayrıca köşeli parantezler
|
||||
ile çevrelenmiş olması programatik olarak da ayrıştırılabilmesine
|
||||
olanak sağlıyor.
|
||||
|
||||
%h4#rewrite
|
||||
%a.anchor{ href: "#rewrite", aria_hidden: "true" }
|
||||
Değişiklik kayıtlarınızı tekrar yazmalı mısınız?
|
||||
|
||||
%p
|
||||
Tabii ki. Her zaman değişiklik kayıtlarını geliştirmek için iyi sebepler vardır.
|
||||
Düzenli olarak açık kaynaklı projelerde bakım yapılmayan değişiklik kayıtları
|
||||
için çekme istekleri yapıyorum.
|
||||
|
||||
%p
|
||||
Ayrıca bir sürümdeki notların arasında önemli bir değişiklikten bahsetmeyi
|
||||
unutmuş olduğunuzu fark edebilirsiniz. Değişiklik kayıtlarınızı bu bilgi ışığında
|
||||
güncellemeniz gerektiği gün gibi ortada.
|
||||
|
||||
%h4#contribute
|
||||
%a.anchor{ href: "#contribute", aria_hidden: "true" }
|
||||
Nasıl katkıda bulunabilirim?
|
||||
|
||||
%p
|
||||
Bu belge <strong>doğrunun kendisi</strong> değil; benim ince eleyip
|
||||
sık dokuduğum görüşlerimdir. Beraberinde toparlamış olduğum bilgiler
|
||||
ve örnekler bulunur.
|
||||
|
||||
%p
|
||||
Bunu istememin sebebi topluluğun ortak bir paydada buluşmasını istememdir.
|
||||
İnanıyorum ki tartışmanın kendisi de sonucu kadar önemli.
|
||||
|
||||
%p
|
||||
Yani, lütfen <strong>#{link_to "siz de katılın", gh}</strong>.
|
||||
|
||||
.press
|
||||
%h3 Sohbetler
|
||||
%p
|
||||
Geliştiricilerin ve katkıda bulunanların neden değişiklik kayıtlarını
|
||||
dikkate almaları gerekliliğini ve bu projenin arkasındaki motivasyonu
|
||||
anlattığım #{link_to "Değişiklik Kayıtları podcast", thechangelog}'ini
|
||||
inceleyebilirsiniz.
|
||||
Loading…
Reference in New Issue