Ana içeriğe geç

v0.1 ne zaman çıkar?

v0.1 sürümü, projenin temel vaadi tek bir ana senaryoda güvenilir ve tekrarlanabilir şekilde çalıştığı an çıkar.

v0.1'in eksiksiz, mükemmel veya tüm uç durumları kapsayan bir yazılım olması beklenmez. Önemli olan, erken geri bildirim alabilmek ve projenin momentumunu kaybetmemesidir.

Ne zaman?​

  • Çekirdek özellik çalışır hale geldiğinde,
  • Temel kurulum adımları başka bir bilgisayarda denendiğinde ve çalıştığında,
  • Sınırları ve eksikleri açıkça ifade edebildiğinizde.

v0.1 için hazır olma kriterleri​

  1. Çekirdek vaat yerine geliyor mu? Proje bir Markdown dönüştürücü ise, geçerli bir Markdown girdisini hatasız çıktıya dönüştürüyor mu? Evet ise hazırsınız.
  2. Kritik kısıtlar açıkça yazıldı mı? "Şu anda sadece UTF-8 dosyalar desteklenmektedir" veya "Yalnızca Node 20+ üzerinde test edilmiştir" gibi kısıtlamaları README'de belirtin. Kullanıcılar bilinen kısıtları affeder; ancak çalışmayan temel vaatleri affetmez.
  3. Temel bir sürüm etiketi (Git tag) basıldı mı? v0.1.0 etiketi oluşturularak GitHub Releases üzerinde sürüm notları paylaşıldı mı?

v0.1 için beklememeniz gereken durumlar​

  • "Tasarım henüz istediğim kadar şık değil."
  • "Birim test kapsamı (coverage) henüz %90 olmadı."
  • "Tüm olası ortamlarda ve platformlarda kusursuz çalışana kadar bekleyelim." (Hedef platformlarınızı açıkça sınırlayın —örneğin sadece Linux/macOS veya Node 20+— o kapsamı test edip sürümü çıkarın; diğer ortamları yol haritasına bırakın).
  • "Birkaç özellik daha ekleyip öyle çıkalım."

İyi örnek​

Bir CLI projesi için v0.1 sürüm notu:

## Octacity CLI v0.1.0

İlk deneysel sürümümüz yayınlandı! 🎉

### Neler Var?
- `octacity init`: Temel proje şablonunu oluşturur.
- `octacity check`: Yapılandırma dosyalarını doğrular.

### Bilinen Kısıtlamalar
- İlk sürümde yalnızca macOS ve Linux ortamları desteklenmektedir (Windows desteği planlanmaktadır).
- Eklenti mimarisi aktif değildir.

Sık yapılan hatalar​

  • Sonsuz "pre-alpha" evresi: Projeyi 1 yıl boyunca hiçbir sürüm yayınlamadan depoda bekletmek.
  • Kısıtları gizlemek: Henüz tamamlanmamış yerleri tamamlanmış gibi gösterip kullanıcıların güvenini sarsmak.

Daha fazla bilgi​

İlk sürüm kapsamını dar tutmak için İlk sürümde ne olmalı? rehberine dönebilirsiniz.