Ana içeriğe geç
Topluluğa katıl

Katkıda Bulunma

Ticaret İstatistik açık bir topluluk projesidir. İster bir blog yazısı kaleme alın, ister kod katkısı sağlayın — bu rehber size adım adım eşlik eder.

Bölüm 01

Blog Yazarlığı

Programlama veya teknik bilgi gerektirmez. Yazınızı iki farklı yöntemle hazırlayabilirsiniz — alıştığınız bir editörle ya da doğrudan markdown formatında.

Yöntem 1

Google Docs veya Microsoft Word ile Hazırlama

Markdown ile çalışma konusunda tecrübeniz yoksa, yazınızı alışık olduğunuz bir editörde hazırlayabilirsiniz.

  1. Yazınızı yazın.
    • Başlık, alt başlıklar ve paragraflar açık olmalı.
    • Yazım kurallarına dikkat edin.
    • Mümkün olduğunca kısa ve öz tutun.
    • Sonunda kaynaklarınızı belirtin (varsa).
  2. Form için bilgilerinizi hazırlayın.
    Yazı Bilgileri
    • Yazı başlığı
    • İçerik etiketleri
    • Yazı dosyası (Docs veya Word)
    Yazar Bilgileri
    • Ad ve soyad
    • Unvan veya rol
    • Kullanıcı adı (küçük harfle)
    • Kare profil fotoğrafı (1:1)
    • Web/GitHub/LinkedIn URL'si
  3. Başvuru formunu doldurun.

    Yazınızı ve bilgilerinizi aşağıdaki form üzerinden gönderin.

    Blog Yazısı Başvuru Formu
Yazınız markdown formatına çevrilip blog bölümüne eklenir. Bu süreç birkaç gün alabilir — sabrınız için teşekkürler.
Yöntem 2

Markdown Formatında Hazırlama

Markdown ile çalışmayı tercih ediyorsanız, yazınızı doğrudan repoya ekleyebilirsiniz.

  1. Yazınızı markdown formatında hazırlayın. Markdown hakkında bilgi için Markdown Guide sayfasını ziyaret edebilirsiniz.
  2. blog klasörü altında yeni bir klasör oluşturun (format: YYYY-MM-DD-yazinizin-basligi).
  3. Klasörün içine index.md dosyasını ekleyin.
  4. Yazınızın başına aşağıdaki metadatayı yerleştirin:
    ---
slug: yazinizin-url-adresi
title: Yazınızın Başlığı
authors: [kullanici-adiniz]
tags: [etiket1, etiket2]
---
  5. blog/authors.yml dosyasına yazar bilgilerinizi ekleyin:
    kullanici-adiniz:
  name: İsim Soyisim
  title: Unvan / Rol
  url: https://github.com/github-kullanici-adiniz
  image_url: /img/authors/kullanici-adiniz.jpg
Bölüm 02

Kod Katkısı

Web sitesinin koduna katkıda bulunmak için standart GitHub iş akışını kullanıyoruz. Aşağıdaki adımlar tipik bir katkı sürecini özetler.

Süreç

Katkı Akışı

  1. Önce issues sayfasını kontrol edin.
  2. Yapmak istediğiniz değişiklik için yeni bir issue açın.
    • Değişikliğin amacını açıklayın.
    • Nasıl uygulayacağınızı kısaca anlatın.
  3. Issue üzerinde geri bildirim alın.
  4. Repository'yi forklayın.
  5. Değişikliklerinizi yapın.
  6. Pull Request açın.
    • İlgili issue'yu referans gösterin (#issue-number).
    • Değişikliklerinizi detaylıca açıklayın.
Kurulum

Geliştirme Ortamı

Lokal geliştirme ortamını kurmak için aşağıdaki adımları takip edin.

  1. Repository'yi klonlayın:
    git clone git@github.com:ticaretistatistik/ticaretistatistik.com.git
  2. Bağımlılıkları yükleyin:
    cd ticaretistatistik.com
npm install
  3. Geliştirme sunucusunu başlatın:
    npm start

Yardım ve İletişim

Aklınızda bir soru mu var? Ya da takıldığınız bir nokta mı oldu? GitHub issues sayfasında yeni bir konu açabilir, topluluğa ulaşabilirsiniz.