BotreamDokümanlar Web sitesi English v0.1.1

Sürümler ve çalışma alanları

Her görevin, zamanlamaların ve çalıştırmaların kullandığı numaralı sürümlerin bulunduğu bir genel çalışma alanı ve kullanıcı başına, bir görevi kimseyi etkilemeden değiştirdiğiniz bir yerel çalışma alanı vardır. Bir görevi değiştirmek için onu çekersiniz, istediğiniz sıklıkta kaydedersiniz ve bir sonraki sürümü yayınlamak için yayınlarsınız.

Genel ve yerel

Genel Yerel
İçerdikleri Yayınlanmış sürümler; 1, 2, 3… şeklinde numaralanır. Sürümler yayınlandıktan sonra asla değişmez. Kopyalarınız: çektiğiniz veya klonladığınız görevler ve henüz yayınlamadığınız yeni görevler
Kimler görür Edit tasks yetkisine sahip herkes Yalnızca siz; hiç yayınlanmamış bir görev başkalarına görünmez
Kullananlar Zamanlamalar, görev listesinden yapılan çalıştırmalar, API Kopyanız üzerinde çalışırken düzenleyiciden başlattığınız çalıştırmalar
Düzenleyicide Salt okunur Çekildiğinde düzenlenebilir, klonlandığında salt okunur

Aralarında Tasks sayfasının üstündeki Local ve Public ile geçiş yapın. Düzenleyicide görev adının yanındaki etiketler neye baktığınızı belirtir; örneğin Public · v4, Local · pulled from v4 veya Local clone of v4.

Not: Bir görevi aynı anda yalnızca bir kişi değiştirebilir. Çekme işlemi görevi kilitler; böylece kimsenin değişiklikleri birleştirmesi gerekmez.

Olağan döngü

  1. Görevi çekin (Pull; Public listesinde veya düzenleyicide). Geçerli genel sürüm yerel çalışma alanınıza kopyalanır ve görev başkalarına kilitlenir.
  2. Görevi düzenleyin ve istediğiniz sıklıkta kaydedin (Save, Ctrl+S). Kaydetme yalnızca yerel kopyanızı yazar; sürüm oluşturulmaz. Kopyanız çektiğiniz sürümden farklı olduğunda görev listesi Modified gösterir.
  3. Test etmek için yerel kopyanızı düzenleyiciden çalıştırın (Run) veya hata ayıklayın (Debug).
  4. Görevi yayınlayın (Push). Kopyanız bir sonraki genel sürüm olur ve kilit kaldırılır.

Yeni görevler yerel çalışma alanınızda başlar (New · never pushed) ve ilk yayınlamayla genel hale gelir.

Pull

Pull (çekme), geçerli genel sürümü düzenlenebilir bir kopya olarak yerel çalışma alanınıza kopyalar ve görevi kilitler: siz yayınlayana veya iptal edene kadar başka hiç kimse onu çekemez, yayınlayamaz veya silemez. Bir görev çekilmişken genel liste, görevi kimin tuttuğunu Pulled by sütununda gösterir; diğer kullanıcılar ise Pull düğmesini, görevi tutan kişinin adıyla birlikte devre dışı görür.

Bağımlılıklarla çekme

Pull with dependencies… (bir görevin menüsünde), bu görevin runtask ile doğrudan veya birbirleri üzerinden çağırdığı görevleri listeler. Her biri için seçin:

Eylem Etkisi
Pull Onu da değiştirmek için kopyalar (başkalarına kilitlenir)
Clone Yerel kopyanızı onun mevcut haliyle çalıştırmak için salt okunur olarak kopyalar
Skip Olduğu gibi bırakır; yerel çalıştırmalar onun genel sürümünü kullanır

Başka birinin çektiği bir görev yalnızca klonlanabilir veya atlanabilir. Çekme işlemi ya hep ya hiç şeklindedir: görevlerden biri çekilemezse hiçbiri çekilmez.

Save

Save (Ctrl+S) yerel kopyanızı kaydeder. Görevde hatalar veya boş zorunlu alanlar varken devre dışıdır; bkz. Görev düzenleyici. Düzenleyici, kaydedilmemiş değişikliklerle ayrılmadan önce sizi uyarır.

Push

Push (yayınlama) bir pencere açar:

  • What changed? — sürüm geçmişinde gösterilen isteğe bağlı bir not.
  • Keep it pulled to continue working on it — yayınlamadan sonra yerel kopyanızı ve kilidi korur. Bu seçenek olmadan yerel kopya kaldırılır ve görevin kilidi açılır.

Düğme hangi sürümü oluşturacağınızı belirtir (Push as version 5). Yayınlanacak bir şey olmadığında, yani kopyanız genel sürümle aynı olduğunda Push devre dışıdır. Yayınlamadan önce değişikliklerinizi kaydedin; yayınlanan, kaydedilmiş yerel kopyadır.

Uyarı: Yayınlanan sürüm, o andan itibaren zamanlamaların ve diğer kullanıcıların çalıştırdığı sürümdür. Yayınlamadan önce yerel kopyanızı test edin.

Cancel pull

Cancel pull (çekmeyi iptal etme), yerel kopyanızı atar ve görevin kilidini açar. Genel sürüm olduğu gibi kalır. Hiç yayınlanmamış bir görev için menüde Delete (never pushed) yazar: görev yalnızca sizin çalışma alanınızda bulunur ve silinir.

Clone

Clone (read-only copy) (klonlama), geçerli genel sürümün salt okunur bir kopyasını yerel çalışma alanınıza koyar. Bir görevi başka biri çekmişken de klonlayabilirsiniz; örneğin onu yerel olarak çalıştırmak veya kendi çektiğiniz görevlerin onu mevcut haliyle çağırmasını sağlamak için.

  • Daha yeni bir sürüm yayınlandığında görev listesi klonu Outdated olarak işaretler ve menü Update clone to v5 seçeneğini sunar.
  • Remove clone kopyayı siler.
  • Klonladığınız bir görevi çekmek, klonu düzenlenebilir kopyanıza dönüştürür.

Kilidi kaldırma

Release task locks yetkisine sahip kullanıcılar (varsayılan olarak Admin) bir kilidi birinin elinden alabilir: Public listesindeki görev menüsünde Release lock of …. Kişi yayınlamadığı değişiklikleri kaybeder ve ardından herkes görevi çekebilir. Çekme, çekmeyi iptal etme, klonlama ve kaldırılan kilitler denetim günlüğüne kaydedilir.

Sürüm geçmişi

Düzenleyici araç çubuğundaki History, yayınlanmış sürümleri en yeniden başlayarak not, yazar ve zaman bilgisiyle listeler. Latest en yeni sürümü işaretler; Base yerel kopyanızın çekildiği sürümü işaretler (salt okunur bir sürüme bakarken Shown).

Çekilmiş bir kopyada Load, örneğin bir değişikliği geri almak için daha eski bir sürümü düzenleyiciye yükler. Onu kaydedin, ardından yeni bir sürüm olarak yayınlamak için yayınlayın; eski sürümün kendisi değişmeden kalır.

Sürümleri karşılaştırma

Geçmişteki Compare veya History yanındaki karşılaştırma düğmesi Compare versions penceresini açar: iki sürümün görev metni, farklar vurgulanmış olarak yan yana.

  • Üstten iki tarafı seçin; değiştirme düğmesi bunların yerini değiştirir.
  • Yerel kopyanızda Your local copy (editor) bir taraf olarak sunulur; böylece mevcut değişikliklerinizi çektiğiniz sürümle karşılaştırabilirsiniz (buna kaydetmediğiniz değişiklikler de dahildir).
  • No differences, iki tarafın aynı olduğu anlamına gelir.

Yerel kopyayı çalıştırma

Düzenleyici gösterdiğini çalıştırır. Yerel bir kopyada (çekilmiş bir kopya veya hiç yayınlanmamış bir görev) Run, kaydedilmiş yerel kopyanızı çalıştırır; genel görünümde ise genel sürümü çalıştırır. Yerel çalıştırmalar Debug tasks yetkisi (varsayılan olarak Developer) gerektirir.

Yerel bir çalıştırma runtask ile başka görevleri çağırdığında, varsa bunların yerel kopyalarınızı (çekilmiş veya klonlanmış), yoksa genel sürümlerini kullanır. Bu, bir değişikliği hiçbirini yayınlamadan önce birden fazla görev genelinde test etmenizi sağlar.

Çalıştırmalar, yerel bir kopyanın çalıştırılıp çalıştırılmadığını ve hangi sürüme dayandığını kaydeder.

Kim ne yapabilir

Eylem Roller
Oluşturma, çekme, kaydetme, yayınlama, klonlama, çekmeyi iptal etme Edit tasks
Yerel kopyayı çalıştırma Debug tasks
Başka birinin kilidini kaldırma Release task locks

Bkz. Kullanıcılar ve roller.

Botream 0.1.1 · Oluşturulma 2026-10-14