GitHub Notları ve İpuçları

İçindekiler

Hesap Yönetimi
Depo İşlemleri
Sorunlar ve Çekme İstekleri
GitHub Actions
GitHub Pages
GitHub CLI
İşbirliği Özellikleri
GitHub Güvenliği
GitHub Projeleri
GitHub API
En İyi Uygulamalar

Hesap Yönetimi

Yeni bir hesap oluşturma

https://github.com adresine gidin
"Sign up" (Kaydol) düğmesine tıklayın
Hesabınızı oluşturmak için yönergeleri izleyin

İki faktörlü kimlik doğrulamayı (2FA) ayarlama

Ayarlar > Şifre ve kimlik doğrulama bölümüne gidin
"İki faktörlü kimlik doğrulamayı etkinleştir" seçeneğine tıklayın
Tercih ettiğiniz 2FA yöntemini seçin (uygulama veya SMS)

SSH anahtarı oluşturma

Terminali açın
Şu komutu çalıştırın: ssh-keygen -t ed25519 -C "e-posta_adresiniz@ornek.com"
Genel anahtarı GitHub hesabınıza Ayarlar > SSH ve GPG anahtarları bölümünde ekleyin

Depo İşlemleri

Yeni bir depo oluşturma

Sağ üst köşedeki "+" simgesine tıklayın
"New repository" (Yeni depo) seçeneğini seçin
Depo ayrıntılarını doldurun ve "Create repository" (Depo oluştur) düğmesine tıklayın

Bir depoyu çatallama

Çatallamak istediğiniz depoya gidin
Sağ üst köşedeki "Fork" (Çatalla) düğmesine tıklayın

Bir depoyu klonlama

git clone https://github.com/kullaniciadi/depo.git

Yeni bir dal oluşturma

git checkout -b yeni-dal-adi

Değişiklikleri GitHub'a gönderme

git push origin dal-adi

Sorunlar ve Çekme İstekleri

Yeni bir sorun oluşturma

Deponun "Issues" (Sorunlar) sekmesine gidin
"New issue" (Yeni sorun) düğmesine tıklayın
Başlık ve açıklamayı doldurun
"Submit new issue" (Yeni sorunu gönder) düğmesine tıklayın

Çekme isteği oluşturma

Deponun "Pull requests" (Çekme istekleri) sekmesine gidin
"New pull request" (Yeni çekme isteği) düğmesine tıklayın
Birleştirmek istediğiniz dalı seçin
Başlık ve açıklamayı doldurun
"Create pull request" (Çekme isteği oluştur) düğmesine tıklayın

Çekme isteği inceleme

"Pull requests" (Çekme istekleri) sekmesine gidin
İncelemek istediğiniz çekme isteğine tıklayın
Farkı görmek için "Files changed" (Değişen dosyalar) sekmesine tıklayın
Yorum yapın veya değişiklikleri onaylayın

Çekme isteği birleştirme

Çekme isteğine gidin
"Merge pull request" (Çekme isteğini birleştir) düğmesine tıklayın (tüm kontroller geçtiyse)
Birleştirmeyi onaylayın

GitHub Actions

Yeni bir iş akışı oluşturma

Deponuzda .github/workflows dizini oluşturun
Bu dizinde yeni bir YAML dosyası oluşturun (örneğin, ci.yml)
İş akışınızı GitHub Actions sözdizimini kullanarak tanımlayın

Örnek iş akışı:

name: CI

on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    
    steps:
    - uses: actions/checkout@v2
    - name: Tek satırlık bir betik çalıştır
      run: echo Merhaba, dünya!

İş akışı sonuçlarını görüntüleme

Deponuzdaki "Actions" (Eylemler) sekmesine gidin
Ayrıntılarını ve günlüklerini görmek için bir iş akışına tıklayın

GitHub Pages

GitHub Pages'i etkinleştirme

Depo Ayarları'na gidin
"GitHub Pages" bölümüne kaydırın
GitHub Pages siteniz için kaynak dalı seçin
(İsteğe bağlı) Bir tema seçin veya özel alan adı ayarlayın

GitHub Pages sitenize erişme

Siteniz https://kullaniciadi.github.io/depo adresinde kullanılabilir olacak

GitHub CLI

GitHub CLI'yi yükleme

https://cli.github.com/ adresindeki talimatları izleyin

GitHub CLI ile kimlik doğrulama

gh auth login

Depo oluşturma

gh repo create depo-adi

Sorun oluşturma

gh issue create --title "Sorun başlığı" --body "Sorun açıklaması"

Çekme isteği oluşturma

gh pr create --title "ÇI başlığı" --body "ÇI açıklaması"

İşbirliği Özellikleri

İşbirlikçileri davet etme

Depo Ayarları > Erişim yönetimi bölümüne gidin
"Invite a collaborator" (Bir işbirlikçi davet et) düğmesine tıklayın
Davet etmek istediğiniz kişinin kullanıcı adını veya e-posta adresini girin

Takım oluşturma

Organizasyon sayfanıza gidin
"Teams" (Takımlar) sekmesine tıklayın
"New team" (Yeni takım) düğmesine tıklayın
Takım ayrıntılarını doldurun ve üyeleri ekleyin

Kod inceleme ataması

Depo Ayarları > Branches (Dallar) bölümüne gidin
"Branch protection rules" (Dal koruma kuralları) altında "Add rule" (Kural ekle) düğmesine tıklayın
Çekme istekleri için gerekli inceleyicileri ayarlayın

GitHub Güvenliği

Dependabot uyarılarını etkinleştirme

Depo Ayarları > Güvenlik ve analiz bölümüne gidin
"Dependabot alerts" (Dependabot uyarıları) seçeneğini etkinleştirin

Kod taraması ayarlama

Depo Ayarları > Güvenlik ve analiz bölümüne gidin
GitHub Actions kullanarak "Code scanning" (Kod taraması) ayarlayın

Güvenlik politikası oluşturma

Deponuzda bir SECURITY.md dosyası oluşturun
Güvenlik politikanızı ve güvenlik açıklarının nasıl bildirileceğini tanımlayın

GitHub Projeleri

Yeni bir proje oluşturma

Profilinize veya organizasyonunuza gidin
"Projects" (Projeler) sekmesine tıklayın
"New project" (Yeni proje) düğmesine tıklayın
Bir şablon seçin veya sıfırdan başlayın

Projeye öğe ekleme

Projenizi açın
"+ Add item" (Öğe ekle) düğmesine tıklayın
Yeni bir öğe oluşturun veya mevcut bir sorunu veya çekme isteğini bağlayın

Özel alanlar oluşturma

Projenizde "+" düğmesine tıklayın
Alan türünü seçin (metin, sayı, tarih vb.)
Alanınızı adlandırın ve seçeneklerini yapılandırın

GitHub API

Kişisel erişim belirteci oluşturma

Ayarlar > Geliştirici ayarları > Kişisel erişim belirteçleri bölümüne gidin
"Generate new token" (Yeni belirteç oluştur) düğmesine tıklayın
Kapsamları seçin ve belirteci oluşturun

API isteği yapma

Curl kullanarak:

curl -H "Authorization: token BELIRTECINIZ" https://api.github.com/user

GitHub CLI kullanarak:

gh api user

En İyi Uygulamalar

Anlamlı taahhüt mesajları kullanın: Yapılan değişiklikleri açıklayan net, özlü taahhüt mesajları yazın.
Dal koruma kurallarını kullanın: Birleştirmeden önce kod incelemesi ve CI kontrollerini zorunlu kılmak için dal koruma kuralları ayarlayın.
Depoları düzenli tutun: Sorunları ve çekme isteklerini düzenlemek için etiketler, projeler ve kilometre taşları kullanın.
Projenizi belgeleyin: Başkalarının projenizi anlamasına ve katkıda bulunmasına yardımcı olmak için kapsamlı bir README.md ve CONTRIBUTING.md dosyası bulundurun.
GitHub Actions'tan yararlanın: CI/CD, test ve diğer tekrarlayan görevler için iş akışınızı GitHub Actions ile otomatikleştirin.
Anlamsal sürümlendirme kullanın: Projenizin yeni sürümlerini yayınlarken anlamsal sürümlendirme ilkelerini (MAJOR.MINOR.PATCH) izleyin.
Hassas verileri koruyun: API anahtarları veya şifreler gibi hassas bilgileri asla taahhüt etmeyin. Bunun yerine GitHub Actions için GitHub Secrets kullanın.
GitHub Discussions'ı kullanın: Açık kaynak projeler için topluluk katılımını teşvik etmek üzere GitHub Discussions'ı etkinleştirin.
Düzenli bakım: Bağımlılıkları düzenli olarak güncelleyin, güvenlik uyarılarını ele alın ve eski dalları ve kapatılmış sorunları temizleyin.
Davranış Kuralları: Topluluk kurallarını belirlemek için projeniz için bir Davranış Kuralları uygulayın.