Lepaskan dulu atau dokumentasikan dulu?

Saya telah mengerjakan proyek selama beberapa tahun sekarang, dan saya mulai mengumpulkan basis pengguna yang layak. Saya telah membuat halaman proyek dengan beberapa dokumentasi dasar, tetapi sebenarnya tidak lebih dari sebuah FAQ pada saat ini. Saya tahu bahwa saya perlu memperbaikinya sehingga lebih informatif untuk pengguna baru dan pengguna yang kuat, dan itu adalah daftar tugas saya berikutnya untuk rilis berikutnya.

Namun, rilis berikutnya memiliki fitur yang ingin didapatkan oleh basis pengguna. Saya siap untuk merilisnya sekarang, itu sudah dikemas dan siap untuk pergi. Saya hanya perlu menyebarkannya ke layanan distribusi yang sesuai.

Ke titik. Fitur-fiturnya penting bagi pengguna saya, tetapi dokumentasinya penting bagi saya. Haruskah saya menunggu untuk merilis sampai setelah saya menulis ulang dokumentasi? Basis pengguna saya saat ini cukup cerdas untuk memahami cara menggunakan fitur baru, jadi bukan itu yang saya khawatirkan. Mungkin butuh beberapa minggu untuk menyelesaikan dokumen, karena saya memiliki waktu luang terbatas untuk mengerjakan proyek ini, tetapi komunitas akan memanggang saya dengan ludah jika saya membuat mereka menunggu lebih lama.

Apakah pelanggan benar dalam skenario ini? Haruskah fitur yang fantastis dan langsung untuk pengguna yang ada lebih diutamakan daripada dokumentasi yang kuat untuk pengguna baru?

Pembaruan: Wow, banyak sekali tanggapan hebat dan berkualitas tinggi! Anda benar-benar membantu saya mendapatkan pemahaman yang lebih baik tentang bagaimana saya harus berinteraksi dan mendukung proyek dan penggunanya. Terima kasih banyak!

Sederhana: Rilis versi beta! Kemudian ketika dokumentasi selesai, lakukan rilis final untuk versi baru.

Jika Anda memiliki pengguna yang mau mencoba hal-hal baru, maka manfaatkanlah itu. Anda akan mendapatkan laporan bug, Anda mungkin mendapatkan pertanyaan komunitas tentang poin-poin sulit sehingga Anda tahu di mana harus berkonsentrasi pada dokumentasi, dll. Anda mungkin juga ingin mengubah beberapa hal berdasarkan umpan balik pengguna, yang dapat memengaruhi dokumentasi.

Pada dasarnya, semua orang menang.

Salah satu alasan untuk tidak melakukan rilis awal adalah, jika Anda berpikir pengguna Anda tidak akan menerima "versi beta", maka Anda harus berpikir dua kali untuk melakukannya, tetapi mengikuti apa yang Anda tulis, sepertinya mereka akan senang karenanya.

Alasan lain adalah, jika ada kesulitan teknis tentang melakukan rilis beta menggunakan saluran rilis apa pun yang Anda gunakan. Maka mungkin lebih merepotkan daripada layak untuk melakukan rilis beta dan final yang terpisah. Jika Anda berpikir perangkat lunak Anda selesai, maka dalam hal ini saya akan bersandar pada rilis awal, perbarui dokumentasi ketika sudah selesai. Kalau tidak, ada risiko dokumentasi tertunda, dan kemudian seluruh rilis tertunda atau Anda akhirnya melepaskan tanpa dokumentasi akhir, jadi lakukan saja sekarang.

Jika saya benar, Anda melakukan proyek ini di waktu luang dan tanpa uang . Jika ini masalahnya, silakan, lakukan apa yang membuat Anda merasa lebih baik (pengguna menunggu, mendokumentasikan waktu Anda). Anda seharusnya tidak merasakan tekanan dari "pengguna" Anda. Banyak orang menulis tentang ini di Internet (penulis dan kontributor FLOSS besar yang merasakan tekanan).

Tetapi, jika Anda dibayar, atau Anda mendapat manfaat, silakan lakukan apa yang diinginkan pengguna Anda. Ini berarti melakukan apa pun yang terbaik untuk pelanggan atau pengguna Anda , dalam hal ini, cukup lepaskan dan dokumentasikan pada waktu Anda. Anda mengatakan mereka akan menemukan jalan mereka, jadi itu seharusnya tidak menjadi masalah besar.

Secara umum ada dua jenis dokumentasi: teknis yang mendokumentasikan kode Anda (kelas, unit, dll) dan bagaimana fitur baru dapat beroperasi dan diimplementasikan dalam kode dan dokumentasi pengguna. IMO, dokumentasi teknis adalah suatu keharusan terutama jika pengembangan perangkat lunak bukan pekerjaan penuh waktu Anda. Saya menghabiskan banyak waktu dalam hal ini karena saya mungkin memiliki periode besar dalam penulisan kode karena komitmen seumur hidup.

Dokumentasi pengguna bagus untuk dimiliki tetapi saya rasa tidak penting. Tentu saja itu tergantung pada kompleksitas aplikasi, keakraban basis pengguna dengan penggunaan komputer dan sistem dalam area subjek dalam diskusi - dalam kasus Anda sepertinya pelanggan Anda dapat memahami bagaimana fitur-fitur baru bekerja. Ada banyak pemikiran di luar sana yang berpendapat bahwa pengalaman pengguna yang baik dan antarmuka pengguna yang baik membutuhkan dokumentasi pengguna yang minimal.

Juga, jika waktu Anda terbatas dan Anda benar-benar merasa tertekan untuk mengembangkan dokumentasi seperti yang Anda sarankan, Anda dapat membuat beberapa video pendek hanya memperkenalkan fitur-fitur baru. Ini akan memberi Anda waktu untuk menulis dokumentasi yang sebenarnya dan kemudian Anda dapat mengisi rincian yang kurang penting.

Beberapa kiat pemasaran memungkinkan Anda menyeimbangkan harapan pengguna dan masih meningkatkan merek Anda. Ini benar-benar tergantung pada jenis aplikasi dan alur kerja yang telah Anda buat sejauh ini, tetapi Anda bisa memiliki layar pembuka untuk versi baru Anda dan di dalam aplikasi Anda dapat menampilkan video baik dengan menyediakan tautan atau dengan memutar video di dalam aplikasi.

Hanya untuk menambahkan sesuatu tidak hanya untuk contoh spesifik ini tetapi untuk alur kerja umum:

Dokumentasi mungkin menjadi milik Anda definition of done, tetapi dokumentasi sering kali melampaui produk minimum yang layak (MVP).

Tidak hanya pelanggan selalu benar. Jika itu adalah produk komersial, melepaskan mungkin banyak nilai bisnis dan merupakan prioritas mutlak.

Pemilik menentukan nilai bisnis (yang menurut Anda), jadi apa yang lebih berharga sebagai produk bagi pelanggan Anda?

Juga adakah risiko melepaskan tanpa dokumentasi?

Misalnya kompetisi ; Jika kompetisi merilis fitur super ini sebelum Anda, Anda mungkin kehilangan beberapa pengguna.

Tanyakan kepada diri sendiri atau pemilik produk pertanyaan-pertanyaan ini dan jawaban Anda akan jelas.

Fitur baru membuat pengguna lama senang. Dokumentasi yang baik mengundang pengguna baru. Di mana Anda harus berkonsentrasi tergantung pada kebutuhan Anda. Anda mengindikasikan bahwa basis pengguna sehat sehingga fitur-fitur baru dapat menunggu. Berbicara sebagai pengguna lama, saya juga menyukai dokumentasi yang bagus. Hal yang menyenangkan tentang open source: pengguna lama menambahkan fitur mereka sendiri.

Anda belum mengklarifikasi dalam pertanyaan Anda dan mungkin tidak kepada pengguna Anda konsekuensi dari pilihan ini. Berapa banyak waktu yang Anda habiskan untuk dukungan pengguna? Apakah dokumentasi tambahan akan mengurangi jumlah waktu yang Anda habiskan untuk dukungan atau meningkatkan penjualan? Apa keuntungan bagi Anda untuk melakukan dokumentasi?

Pengguna Anda menginginkan fitur baru di atas dokumentasi, tetapi apakah mereka menyadari mungkin ada penurunan ketersediaan Anda untuk memberikan dukungan, memperbaiki bug, melepas tambalan, dll?

Jika saya tidak repot-repot membaca instruksi ketika yang harus saya lakukan adalah mengirimi Anda email dengan pertanyaan saya, mengapa saya ingin dokumentasi dengan fitur baru?

Jika paket siap dirilis, lepaskan ke pelanggan / klien dan mulailah mengerjakan dokumentasi. Sebaiknya berkomunikasi dengan klien, ketika Anda akan membagikan dokumentasi yang membantu mereka memahami fitur yang digunakan.