İlk önce serbest bırakılsın mı yoksa ilk önce belgenin mi?

Birkaç yıldır bir proje üzerinde çalışıyorum ve iyi bir kullanıcı tabanı toplamaya başladım. Bazı temel belgelere sahip bir proje sayfası oluşturdum, ancak bu noktada bir SSS'den başka bir şey değil. Hem yeni hem de ileri düzey kullanıcılar için daha bilgilendirici olacak ve onu bir sonraki sürüm için yapılacaklar listemde sırada olacak şekilde geliştirmem gerektiğini biliyorum.

Bununla birlikte, bir sonraki sürüm, kullanıcı tabanının edinme konusunda endişeli olduğu özelliklere sahiptir. Şu anda bırakmaya hazırım, paketlenmiş ve gitmeye hazır. Sadece uygun dağıtım servislerine dağıtmam gerekiyor.

Diyeceğim şey şu ki. Özellikler kullanıcılarım için önemlidir, ancak belgeler benim için önemlidir. Belgeleri yeniden yazana kadar serbest bırakmak için beklemeli miyim? Mevcut kullanıcı tabanım yeni özelliklerin nasıl kullanılacağını anlamak için yeterince anlayışlı, bu yüzden endişelendiğim şey bu değil. Bu proje üzerinde çalışmak için boş zamanım olduğu için, dokümanları bitirmek birkaç hafta alabilir, ancak onları daha fazla bekletirsem topluluğum tükürür.

Müşteri bu senaryoda doğru mu? Mevcut kullanıcılar için fantastik ve anlaşılır bir özellik, yeni kullanıcılar için sağlam belgelere göre öncelik kazanmalı mı?

Güncelleme: Vay, çok büyük, yüksek kaliteli tepkiler! Hem projeyi hem de kullanıcılarını nasıl etkileşime sokmam ve desteklemem gerektiğini daha iyi anlamama yardımcı oldunuz. Bir milyon teşekkürler!

Basit: Bir beta sürümünü yayınlayın! Sonra belgeler tamamlandığında, yeni sürümün son sürümünü yapın.

Yeni şeyleri denemek isteyen kullanıcılarınız varsa, bundan kesinlikle yararlanın. Hata raporları alırsınız, muhtemelen zor noktalar hakkında topluluk soruları alırsınız, böylece belgelere nerede konsantre olacağınızı vb. Bilirsiniz. Ayrıca, kullanıcı geri bildirimlerine dayanarak dokümantasyonu etkileyebilecek bazı şeyleri ince ayar yapmak isteyebilirsiniz.

Temel olarak, herkes kazanır.

Erken yayın yapmamanın bir nedeni, kullanıcılarınızın bir "beta sürümü" nü kabul etmeyeceğini düşünüyorsanız, o zaman bunu iki kez düşünmelisiniz, ama yazdıklarınızı takip edersek, onun için mutlu olacak gibi sesler çıkarmalısınız.

Başka bir neden, kullandığınız yayın kanallarını kullanarak beta sürümü yayınlama konusunda teknik zorluklar olması durumunda olacaktır. Öyleyse, ayrı beta ve son sürümler yayınlamaya değecek kadar güç olabilir. Yazılımınızın tamamlandığını düşünüyorsanız, o zaman bu durumda erkenden piyasaya sürülmeli, bittiğinde dokümanları güncelleyiniz. Aksi halde, belgelerin ertelenmesi riski vardır ve ardından tüm sürüm ertelenir veya nihai belgelendirme olmadan serbest bırakılmaya başlayabilirsiniz, bu yüzden şimdi yapın.

Seni doğru amacımız, sizin bu projeyi yapıyoruz serbest zaman ve için hiç para . Bu durumda, lütfen, sizi daha iyi hissettiren şeyleri yapın (kullanıcılar bekler, zamanınızı belgeler). "Kullanıcılarınızdan" gelen baskıyı hissetmemelisiniz. Bu konuda birçok kişi internette yazdı (Büyük FLOSS yazarları ve baskıyı hisseden katkıda bulunanlar).

Ancak, ödeme alıyorsanız veya bazı avantajlar alıyorsanız, lütfen kullanıcılarınızın istediğini yapın. Bu , müşterileriniz veya kullanıcılarınız için en iyi olanı yapmak anlamına gelir , bu durumda, sadece yayınlayın ve zamanında belgelendirin. Yollarını bulabileceklerini söyledin, bu yüzden büyük bir sorun olmamalı.

Genel olarak iki tür belge vardır: kodunuzu belgeleyen teknik (sınıflar, birimler, vb.) Ve kod ve kullanıcı belgelerinde yeni özelliklerin nasıl işleyebileceği ve uygulanabileceği. IMO, teknik dokümantasyon , özellikle yazılım geliştirme tam zamanlı işiniz değilse bir zorunluluktur . Hayat taahhüdü nedeniyle büyük boşluklar yazma koduna sahip olabileceğim için çok fazla zaman harcıyorum.

Kullanıcı dokümantasyonunun olması güzel ancak gerekli olmadığına inanıyorum. Elbette, uygulamanın karmaşıklığına, kullanıcı tabanının tartışılan konu alanındaki bilgisayarların ve sistemlerin kullanımına olan aşinalıklarına bağlıdır - sizin durumunuzda, müşterilerinizin yeni özelliklerin nasıl çalıştığını anlayabilmesi gibi görünüyor. İyi bir kullanıcı deneyimi ve iyi bir kullanıcı arayüzü için en az kullanıcı dokümantasyonunun gerekli olduğunu tartışan bir düşünce okulu vardır.

Ayrıca, zamanınız sınırlıysa ve önerdiğiniz gibi belgeler geliştirmek için gerçekten baskı hissediyorsanız, yalnızca yeni özellikleri tanıtan birkaç kısa video yapabilirsiniz. Bu size gerçek belgeleri yazmak için biraz zaman kazandırır ve daha az önemli bilgileri doldurabilirsiniz.

Bazı pazarlama ipuçları, kullanıcı beklentilerini dengelemenize ve markanızı artırmanıza yardımcı olabilir. Gerçekten de uygulamanın türüne ve şu ana kadar oluşturduğunuz iş akışına bağlıdır, ancak yeni sürümünüz için bir hoş geldiniz ekranı olabilir ve uygulamanın içinde ya bağlantılar sağlayarak ya da uygulamanın içindeki videoları oynatarak videoları gösterebilirsiniz.

Sadece bu belirli örnek için değil, genel iş akışı için de bir şeyler eklemek için:

Dokümantasyon sizin olabilir definition of done, ancak dokümantasyon asgari düzeyde uygulanabilir bir ürünün (MVP) ötesinde bir zamandır .

Sadece müşteri her zaman haklı değildir. Eğer ticari bir ürün ise, piyasaya sürmek çok iş değeri olabilir ve mutlak bir önceliktir.

Mal sahibi, iş değerini (hangisini umursuyorsunuz) tanımlar, bu nedenle müşterileriniz için bir ürün olarak daha değerli olan nedir?

Ayrıca dokümantasyon olmadan salıverme riskleri var mı?

Örneğin rekabet ; Yarışma bu süper özelliği sizden önce yayınlarsa, bazı kullanıcıları kaybedebilirsiniz.

Bu soruları kendinize veya ürün sahibinize sorun, cevabınız açık olacaktır.

Yeni özellikler eski kullanıcıları mutlu eder. İyi dokümantasyon yeni kullanıcıları davet eder. Hangisine konsantre olmanız gerektiğine, hangisine daha fazla ihtiyacınız olduğuna bağlı. Kullanıcı tabanının sağlıklı olduğunu, böylece yeni özelliklerin beklediğini söylediniz. Eski bir kullanıcı olarak konuşurken, iyi belgeleri de severim. Açık kaynak ile ilgili güzel bir şey: eski kullanıcılar kendi özelliklerini ekler.

Sorunuzda netleştin ve muhtemelen bu seçeneklerin sonuçlarını kullanıcılarınıza değil. Kullanıcı desteğine ne kadar zaman harcıyorsunuz? Ek belgeler destek için harcadığınız zamanı azaltır mı yoksa satışları artırır mı? Belgelendirme yapmanın avantajı nedir?

Kullanıcılarınız dokümantasyon üzerinde yeni özellikler istiyor, ancak destek sağlama, hataları düzeltme, sürüm düzeltme ekleri, vb. Sağlama durumunuzda bir düşüş olabileceğini biliyorlar mı?

Yapmam gereken tek şey sorumu size bir e-posta göndermek olduğunda talimatları okumayı başaramazsam neden yeni özellikler hakkında dokümantasyon isteyeyim?

Paket serbest bırakılmaya hazırsa, müşteriye / müşteriye bırakın ve belgeler üzerinde çalışmaya başlayın. Dağıtılan özellikleri anlamalarına yardımcı olacak belgeleri paylaşacağınız zaman müşteriyle iletişim kurmak iyidir.