Skip to content

Latest commit

 

History

History
101 lines (65 loc) · 3.37 KB

CONTRIBUTING.md

File metadata and controls

101 lines (65 loc) · 3.37 KB
Raw

Katkı Yapma Rehberi

For English

Katkı yapmadan önce dikkat edilmesi gerekenler

  • İlgilendiğiniz konunun daha önce herhangi bir issue tarafından işlenilmediğine ve başkası tarafından yapılmadığından emin olun.
  • Eğer bir problemle karşılaşırsanız, issue açın.
  • Beklediğiniz, istediğiniz bir değişiklik için issue açın.
  • Yeni bir özellik eklemek için issue açın.
  • Bir hatayı düzeltmek için PR açın.
  • Dökümantasyondaki bir hatayı düzeltmek için PR açın.

Başlamadan önce

Projeyi kurmak

Gereksinimler:

  • php >= 8.1^
  • MySQL >= 7.0^
# Projeyi klonlayın
git clone https://github.com/acikkaynak/deprem-yardimi.git

# Proje dizinine girin
cd deprem-yardimi

# Gereksinimleri yükleyin
composer install

# Geliştirme ortamını başlatın
php artisan serve

Commit mesajları

Her commit mesajı bir başlık, bir gövde ve bir altbilgi içerir. Başlık, tip, bir kapsam ve bir açıklama içeren bir özel biçimde biçimlendirilir:

<type>(<scope>): <description>
<BOŞ SATIR>
<body>
<BOŞ SATIR>
<footer>

Her commit mesajı 72 karakterden uzun olmamalıdır.

Mesaj Başlığı

Mesaj başlığı zorunludur ve bir tür, isteğe bağlı bir kapsam ve bir açıklama içeren kısa bir açıklama içermelidir. İdeal olarak, 50 karakterden uzun olmamalıdır.

Bu kurallara uymak, her sürüm için açık bir değişiklik günlüğü oluşturur.

PR başlığını da commit mesajları için izlemek iyi bir fikirdir. Bu şekilde, PR birleştirildiğinde, PR başlığı son commit mesajı olarak kullanılabilir ve geçmişin düzgün biçimlendirilmiş bir şekilde oluşturulmasını sağlar.

Tip

Tip, commit'in ne tür bir değişiklik olduğunu belirtir. İzin verilen türler:

  • feat: Bir yeni özellik ekler
  • fix: Bir hata düzeltir
  • docs: Sadece dokümantasyonu etkileyen değişiklikler
  • style: Sadece biçimlendirme, noktalama işaretleri, boşluklar, vb. Değişiklikler
  • refactor: Kodun içeriğini değiştirmeyen bir değişiklik
  • perf: Bir performans değişikliği
  • test: Eksik testleri ekler veya mevcut testleri değiştirir
  • chore: Geliştirme sürecini etkilemeyen diğer değişiklikler

Kapsam

Kapsam, commit'in etkilediği bölümü belirtir. Örneğin, kafka veya login gibi bir kapsam belirtilebilir.

Açıklama

Açıklama, commit'in amacını kısa bir şekilde belirtir. İlk harf büyük harfle yazılmalıdır. Açıklama, bir cümle olmalıdır. Bu, commit mesajının başlığı olarak kullanılabilir.

Mesaj Gövdesi

Mesaj gövdesi, commit'in neden yapıldığını açıklayan bir açıklamadır. Gövde, bir veya daha fazla paragraf içerebilir. Her paragraf, 72 karakterden uzun olmamalıdır.

Daha fazla bilgi git commit mesajları yazmak için

Mesaj Alt Bilgisi

Tamamlanan, düzeltilen veya teslim edilen hikayeler, "Finishes", "Fixes" veya "Delivers" anahtar sözcüğüyle başlayan bir ayrı satırda altbilgiye eklenmelidir:

[(Finishes|Fixes|Delivers) #ISSUE_ID]

Mesaj Örneği

feat(34): implement exactly once delivery
- ensure every event published to kafka