wiki

osu! wiki katkı rehberi

osu! wiki'yi daha iyi hale getirmek için gösterdiğiniz ilgiye teşekkür ederiz! Bu hızlı başlangıç kılavuzu GitHub ortamında hiç çalışmamış, osu! wiki'nin katkı iş akışına alışkın olmayan yeni başlayanlar için hazırlanmıştır. Eğer GitHub kullanmakta deneyimliyseniz, bu veri havuzundaki içerik güncellemeleri için ortak feature-branch iş akışını takip edebilir ve bu rehberi atlayabilirsiniz.

Eğer herhangi bir noktada kafanız karıştıysa ve/veya daha fazla yardıma ihtiyacınız varsa, osu!dev Discord sunucusuna (#osu-wiki kanalına) mesaj atmaktan çekinmeyin.

Başlarken

Kayıt olma

  1. Eğer yoksa, GitHub hesabı oluşturmak için kayıt olun.
  2. Fork etme kısmına devam edin.

Fork etme

  1. Fork tuşuna tıklayın.

  2. Fork'unuza gitmek için Fork tuşuna yeniden tıklayın.

  3. Aşağıdakine benzer bir resim görmeniz ppy/osu-wiki reposunun bir fork'unu ortaya çıkardığınız ve şu anda fork'unuzda bulunduğunuz anlamına gelir.

  4. Fork'unuzu senkronlama kısmına devam edin.

Fork'unuzu senkronlama

  1. osu-wiki reponuzun fork'una gidin.

  2. Dosyaların üzerinde, branch'ınızın ppy:master ile kıyaslandığında "behind" (geride), "ahead" (ileride), veya "even" (eşit) olduğunu belirten bir yazı bulunur. Eğer "behind" veya "ahead and behind" gibi bir yazıyla karşılaşırsanız, behind-commit'lerin sayısının bir önemi olmaksızın, branch'ınız güncel değildir.

    İyi (Commit yok ve güncel)

    İyi (Bunlar sizin commit'leriniz)

    Muhtemelen kötü (Branch'ınız güncel değil)

    Muhtemelen kötü (Branch'ınız sizin commit'lerinizle güncel değil)

  3. Eğer zaten değiştirilmiş bir dosyayı düzenlemeyecekseniz, bu pek bir sorun değil. Ancak ne kadar çok commit gerideyseniz, değiştirilmiş dosyalarla karşılaşma durumunuz bir o kadar yüksek.

  4. 4. adımı tamamladığınızda, Çevrimiçi ya da yerel düzenleme kısmına devam edin.

Çevrimiçi ya da yerel düzenleme

Bu noktada iki seçeneiğiniz var:

  • GitHub Web Arayüzü - çevrimiçi düzenleyin; tekli makale düzenleme için en iyisi
  • GitHub Masaüstü - yerel düzenleyin; tekli ve/veya çoklu makale düzenleme için en iyisi (bu resimleri veya dosyaları karşıya yükleme, silme veya taşımayı da içerir)

Not: Düzenleme için yukarıda listelenen iki seçeneğe sınırlı değilsiniz. Rehberi kısa ve öz tutmak adına, bu makalelerde diğer araç-gereçlerin kullanımından detaylıca hatta hiç bahsedilmeyecek. GitHub Web Arayüzü ve GitHub Masaüstü'nün halihazırda yaptıklarını aşağı yukarı yapan başka üçüncü parti uygulamalar da mevcut.

GitHub Web Arayüzü ya da GitHub Masaüstü seçeneklerinden herhangi birini tamamladığınızda, sonraki kısıma devam edebilirsiniz.

Bitirme

Pull request açma

  1. Eğer yeterince hızlıysanız, aşağıdaki sarı sütunu görebilirsiniz.

  2. Eğer görüyorsanız, Compare & pull request butonuna tıklayın (8. adıma atlayın). Aksi halde, New pull request butonuna tıklayın (4. adıma devam edin).

  3. Sonraki sayfada, eğer aşağıda belirtildiği gibi iki buton görüyorsanız, compare across forks'a tıklayın.

    İyi değil.

  4. head fork açılan listesinden sizin kullanıcı adınıza sahip olan seçeneğe tıklayın (ikincisi olmalı).

  5. compare açılan listesinden oluşturduğunuz branch'in olduğu seçeneğe tıklayın (alfabetik olarak sıralıdır).

  6. Create pull request butonuna tıklayın.

  7. Başlığı İngilizce dilinde girin. Bu, neyi değiştirdiğinizin çok kısa bir özeti olmalı.

    Makale çevirileri için, başlıktan önce çevirdiğiniz dilin isminin iki harfli kısaltmasını köşeli parantez içersinde yazın. Başlığınız direkt çevirdiğiniz makalenin/makalelerin ismi bile olabilir. Örneğin, [FR] BBCode sizin BBCode makalesini Fransızcaya çevirdiğinizi gösterir.

  8. Açıklama kutusunu değişikliklerinizin bir özetiyle doldurun. Tamamlanma durumu ve gözden geçirenlerin bilmesi gerekenler gibi, pull request'inizle ilgili her türlü bilginin de altını çizmelisiniz. Aynı zamanda pull request'inizin merge edildiğinde issue'ları otomatik olarak kapatmasını açıklamaya "resolves #1" ya da "closes #1" vs. yazarak sağlayabilirsiniz (Anahtar sözcük kullanarak issue kapatma makalesini GitHub Yardım üzerinden inceleyebilirsiniz).

  9. Hazır olduğunuzda, Create pull request butonuna tıklayın.

  10. Aşağıdaki Gözden geçirmeler ve Merge etme kısımlarına devam edin.

Gözden geçirmeler

Pull request'inizi oluşturduğunuzda, diğer osu! wiki editörleri yaptığınız değişikliklerdeki gözden kaçırdığınız hataların bulunmasında yardımcı olurlar. Bu gözden geçirmelere ayak uydurmak zorundasınız, aksi halde oluşturduğunuz pull request kapatılması için işaretlenebilir! Eğer birilerinin sizin pull request'inizi gözden geçirmesini istiyorsanız, osu!dev Discord sunucusunda (#osu-wiki kanalında) veya GitHub yorumlarında diğer osu! wiki editörlerine sorabilirsiniz.

Merge etme

Değişikliklerinizin osu! wiki üzerinde canlı olarak görüntülenmesi için, pull request'iniz merge edilmelidir. Pull request'iniz gözden geçirilip onaylandığında, GitHub'taki yorum kısmını ya da osu!dev Discord sunucusunda (#osu-wiki kanalında) birisinden merge etmesini isteyebilirsiniz. Merge edildiğinde, yaptığınız değişikliklerin osu! wiki üzerinde canlı olarak yer alması beş saati bulabilir.