Repository Branch Layout

The layout of our branches is designed to assist semantic versioning by allowing us to make minor releases without a breaking change forcing us to make it a major release. This branch layout applies to SpongeAPI, SpongeCommon, SpongeForge, and SpongeVanilla repositories but not to the SpongeDocs.

SpongeAPI, SpongeCommon, SpongeForge ve SpongeVanilla

The bleeding dallanması

The core of our repositories is the bleeding branch. Almost all changes will be added to bleeding, including new features, changes, and bugfixes. The version of bleeding will always be the next major release version appended with -SNAPSHOT (e.g. 7.0.0-SNAPSHOT) to denote that it is not yet a final build and subject to change.

“Bleeding” dalının bulunmasının başlıca nedeni, değişiklikler için bir test yerinin bulunmasıdır. Sponge takımının deneyimli üyeleri bile kazara bir yapının başarısız olmasına veya bir hatayı sebep olmasına neden olabilir. “Bleeding” dalı, topluluktaki insanlar tarafından test edilecek ve bu, hataları çok daha kolay bir şekilde giderebileceğimiz anlamına geliyor.

Stabil dallanmalar

Durağan dallar, eklentilerin ve sunucu uygulamalarının üzerine kurulabilecek çok daha istikrarlı bir platformu temsil eder. API için kırılma olmayacak, sadece kırılmayı önleyen eklemeler olmayacaktır. Her büyük API sürümünden sonra, küçük veya düzeltme eki sürümleri de dahil olmak üzere, bu sürümler için en yeni API / uygulamanın bulunduğu bir dal var.

When the time comes to release a major version, a new stable-x branch will be created from bleeding, where x is the new major version - for example, stable-7. bleeding will be appropriately updated to be the next major release as described above.

Bir süre için “kanama(bleeding)” geçiren, bilinen böcekleri olmayan ve bir önceki büyük yayına uygulanabilen değişiklikler, gelecekteki sürüm için “kararlı” dalla kiraz olarak seçilecek. Bunun yerine bir hata düzeltme sürümünün oluşturulacağı derhal bir düzeltme yapılmadığı sürece değişiklikler yeni bir alt sürüm olarak gruplandırılacaktır. Bir sürüm yayınlandığında, API deposunun bu sürümün taahhütüne işaret eden bir etiketi olacaktır.

Gelecek dallanmalar

Yeni özellikler veya değişiklikler feature/foo veya fix/bar dalında oluşturulmalıdır. Bu, en son “bleeding” taahhüdüne dayanmalıdır. Bunun tek istisnası, değişiklikler “bleeding” ‘de ki kırılma değişiklikleri ile uyuşmuyorsa, bu durumda ilgili ``stable-x “e karşı dayanması gerekir. Değişikliğinizin “bleeding“‘e neden dahil edilemediğini (örneğin, daha sonraki bir sürümde Mojang tarafından kaldırılan bir özelliğe hatayı düzeltmek gibi) çekme isteğinizi belirtmelisiniz.

Yapılan değişiklikler bir önceki sürüm için kırılmıyorsa, Sponge takımı değişikliğin “bleeding” ile birleştirilmesinden sonra herhangi bir sorun çıkmadığını varsayarak bir veya daha fazla “stable” dalda değişiklikleri alabilir.

SpongeDocs

The SpongeDocs themselves are unversioned following our philosophy that they will never be finished, but instead in a constant flux of ever increasing usability. However, they target a specific version of the API, generally the most recent release of SpongeAPI.

Çekirdek dal

SpongeDocs’un temel dalı “stable” dır. Her yeni “stable” taahhüt docs web sitesinin yeniden oluşturulmasını tetikler. “Sabit” durumdaki taahhütler genellikle en yeni SpongeAPI sürümünü belgelemek veya Belgelerdeki küçük hataları düzeltmek için yapılır.

Gelecek dallanmalar

Yeni bir özellik tarif edildiğinde, eski metinler güncellenir veya yeniden derlenir veya belgeler yeniden yapılandırılır, bir feature/foo veya fix/bar dalında yapılır. Bu dallar daha sonra gözden geçirilecek ve tamamlandıklarında birleştirileceklerdir.

A feature branch may only be merged into master if the changes / additions made in it are correct regarding the SpongeAPI release currently targeted by the SpongeDocs. Any feature branches that describe features not yet included in a release stay unmerged until the corresponding API version is released and becomes the new targeted version for the SpongeDocs. However, the Docs team might collect additions for a specific version on a single branch.

Dalları yayımlama

SpongeDocs, API’leri “3.1.0” gibi daha eski API sürümleri ve Dokümanları yayımlamak için “release/x.y.z” dallarını kullanır. Eski API sürümleri, ilgili dalında bulunur. Yeni bir API sürümü her yayımlandığında, Docs Çalışanları daha sonra yeni bir API sürümüne yeni bir release/x.y.z şube ve takas masterı oluşturacaktır. Release dalına bir taahhüt de tıpkı ana daldaki gibi daha eski Docs sürümünün yeniden oluşturulmasını tetikler.