SpongeDocs’un Yazıları

“Sponge Dosyaları” olarak da bilinen Sponge dokümantasyonu, Sponge projesinin resmi belgeleridir. SpongeDocs’un amacı şudur:

  • Kullanıcıların bir Sponge uygulamasıyla güçlendirilmiş öz sunucularını kurmalarına yardımcı olur.
  • Geliştiricilere, Sponge projesine nasıl katkıda bulunacakları konusunda bilgi verin.
  • Geliştiricilere, eklenti geliştirmeye başlama konusunda bilgi verin.

Sorunları bildir

Her zaman bir sayfanın modası geçmiş, bir hata gizlice giriyor ya da yalnızca bir sayfaya bakıp “Peki, bunu açıklamak için daha iyi bir yol var” diye düşünüyorsunuzdur. Durum böyle ve siz, kendinizce bir düzeltme sağlayamıyorsanız, sorunun farkına varmamızın üç yolu var:

  1. SpongeDocs GitHub’da Bir Konu Oluştur <https://github.com/SpongePowered/SpongeDocs/issues> `_
  2. SpongeDocs Forum Kategorisinde Bir Gönderi Oluştur <https://forums.spongepowered.org/c/sponge-docs> _
  3. Irc.esper.net adresindeki #spongedocs kanalında bizi ziyaret edin <ircs: //irc.esper.net: 6697 / # spongedocs> `_ (kaydolmanız gerekiyor)

Dokümanları Yazma

SpongeDocs’a yapılan değişiklikler ve eklemeler, çekme isteği olarak GitHub’daki SpongeDocs havuzuna <https://github.com/SpongePowered/SpongeDocs> `_ gönderilmelidir. Çekme taleplerinin gözden geçirme işlemi sırasında rafine edilmesi yaygın olduğu için hemen mükemmel olmasını gerektirmiyoruz. Eksik açıklamalar da açıktır, anlamak istemediğiniz bazı parçalar varsa utangaç olmayın. Boşlukları doldurabilecek her zaman biri olacak.

The Docs are written in reStructuredText (reST), if you’re familiar with Markdown (md) the step to reST shouldn’t be too hard. If you’re having issues with it we suggest that you join our forums or #spongedocs on irc.esper.net and ask for help there.

The Sponge Documentation is licensed under the Creative Commons - Share-Alike license. Art assets are held under the related Creative Commons - Non Commercial, No Derivatives license. Contributors implicitly accept this licensing.

Stil rehberi

Tüm SpongeDocs sayfalarında tutarlı bir formata sahip olduğumuzdan emin olmak için, Sponge Documentation yazarken geliştirdiğimiz yönergeler aşağıda belirtilmiştir. Dokümanlar büyüdükçe bu liste eklenebilir (şekli değişmiş olabilir).

  1. Başlıklar Başlık Olgusunda Yazılmalıdır (<- example) [# 8 geçerliyse].
  2. Sayfa başlıkları anlamlı olmalıdır (başlığı bir bağlantı olarak görürsünüz).
  3. Program kodu inline literals <http://docutils.sourceforge.net/docs/ref/rst/roles.html#literal> __ veya kod bloklarında bulunmalıdır.
  1. Kod bloklarına çok fazla metin koymamaya çalışın çünkü bunlar çevrilemezler. Katkıda bulunanlar kod bloklarında mümkün olduğunca yorum yapmaktan vazgeçtiler. Bazı örneklerde basit yer tutucu metin gerekli olabilir. İdeal olarak, kod bloğu örnekleri kısa olmalı ve gövde metnindeki her örnek için bir açıklama izlemelidir. Tabii ki, kısa bir örnekle gösterilemeyen bazı kavramlar olabilir.
  2. Use the following code block types for particular code blocks:
  • Groovy/Gradle-Files -> groovy
  • Hocon-Config -> guess (hocon highlighting is not yet supported)
  • In-Game/Server Console Command -> none
  • Java-Code -> java
  • Json-Config -> json
  • Linux-Terminal -> bash
  • Logs -> none
  • Text -> text
  • Windows-Console -> bat
  1. Kullanıcılar için ayrı alanlar tutun, Plugin devs ve Sponge Devs gibi.
  2. Mümkün olduğunca sayfaları paylaşarak tekrarlardan kaçının.
  3. Harici kaynaklara bunları üretmek yerine bağlayın.
  1. Bazı istisnalar çeviri amacıyla yapılır.
  1. SpongeForge, SpongeVanilla ve SpongeAPI arasında ayrım yapın.
  2. Kendi dilinizde kötü görünüyorsa, kendi kurallarınızı bulun.
  3. Sponge, Proje Başlığıdır ve çevrilmemelidir.
  1. Bazı diller de fonetik bir çeviriyi kullanmak isteyebilir.
  1. Automated translations (e.g. Google Translate) are strongly discouraged. These often contain serious errors, and are very likely to be rejected.
  2. Sayfa Başlıkları ve Bölüm Başlıkları, düz metin olmalı, karakter blokları ve diğer biçimlendirmelerden kaçınılmalıdır.
  3. Code symbols should be capitalized in their original form and have no extra spaces (e.g. blockState (a field name) or BlockState (a class name), rather than block state). They should also be formatted as a literal using double backticks (e.g. blockState) in body text.
  4. Satırların maksimum uzunluğu 120 karakter olmalıdır.
  5. İçeri aktarma, her bir makalede ilk kez başvurulduğunda kod bloklarında yazılmalı, ancak ilk defadan sonra tekrar edilmemelidir.

Not

Sponge devamlı değişen bir projedir, gelişme dokümanlarının eksikliği beklenmelidir. Sponge resmi olarak yayımlanıncaya kadar pek çok konuda boşluk olduğundan emin olabilirsiniz. Bununla birlikte, SpongeDocs canlı bir belgedir ve daima düzenlemeye tabidir. Hiçbir zaman kusursuz olamayacak, sadece talep doğrultusunda değişecektir.

Contributions, suggestions and corrections are always welcome.