Phát hành đầu tiên hoặc tài liệu đầu tiên?


23

Tôi đã làm việc trong một dự án vài năm nay và tôi bắt đầu thu thập được một cơ sở người dùng tốt. Tôi đã tạo một trang dự án với một số tài liệu cơ bản, nhưng nó thực sự không nhiều hơn một Câu hỏi thường gặp tại thời điểm này. Tôi biết rằng tôi cần cải thiện nó để nó có nhiều thông tin hơn cho cả người dùng mới và người dùng quyền lực, và đó là danh sách việc cần làm tiếp theo của tôi cho phiên bản tiếp theo.

Tuy nhiên, phiên bản tiếp theo có các tính năng mà cơ sở người dùng đang lo lắng để có được. Tôi đã sẵn sàng để phát hành nó ngay bây giờ, nó được đóng gói và sẵn sàng để đi. Tôi chỉ cần triển khai nó đến các dịch vụ phân phối thích hợp.

Đến điểm. Các tính năng rất quan trọng đối với người dùng của tôi, nhưng tài liệu rất quan trọng đối với tôi. Tôi có nên chờ đợi để phát hành cho đến khi tôi viết lại tài liệu không? Cơ sở người dùng hiện tại của tôi đủ hiểu biết để hiểu cách sử dụng các tính năng mới, vì vậy đó không phải là điều tôi lo lắng. Có thể mất vài tuần để hoàn thành các tài liệu, vì tôi có giới hạn thời gian rảnh để làm việc trong dự án này, nhưng cộng đồng sẽ quay cuồng với tôi nếu tôi khiến họ chờ đợi lâu hơn.

Là khách hàng ngay trong kịch bản này? Một tính năng tuyệt vời, đơn giản cho người dùng hiện tại có nên ưu tiên hơn tài liệu mạnh mẽ cho người dùng mới không?


Cập nhật: Wow, rất nhiều phản hồi tuyệt vời, chất lượng cao! Bạn đã thực sự giúp tôi hiểu rõ hơn về cách tôi nên tương tác và hỗ trợ cả dự án và người dùng. Cảm ơn rất nhiều!


14
Vâng, khách hàng là đúng. Ra mắt bản phát hành, sau đó dành hai tuần để có được tài liệu tại chỗ. Bạn đã nói với chúng tôi rằng cơ sở người dùng sẽ không bị ảnh hưởng bất lợi do thiếu tài liệu và chỉ còn hai tuần nữa. Nếu đây là một buổi biểu diễn thực sự, khách hàng hoặc tổ chức của bạn sẽ rang bạn trên một nhổ thực sự, bởi vì hai tuần không phát hành là hai tuần ít hơn để giành thị phần.
Robert Harvey

3
Tùy thuộc vào dự án, bạn có thể phát hành phiên bản mới trong một nhánh riêng dưới dạng "beta" hoặc "xem trước".
CodeInChaos

2
Những loại tài liệu - tài liệu người dùng cuối hoặc tài liệu mã nguồn? Hoặc là dự án của bạn thuộc loại nào đó không có sự phân biệt giữa những thứ đó?
Doc Brown

5
Dường như không có bất kỳ xung đột nào ở đây: nếu nó được đóng gói và sẵn sàng hoạt động thì tại sao bạn không thể phát hành nó làm việc trên tài liệu tiếp theo, cho một bản cập nhật chỉ dành cho tài liệu trong hai tuần? Bạn có lo ngại rằng việc phát hành sẽ tạo ra rất nhiều công việc (trên các lỗi được báo cáo và vv) sẽ ngăn bạn làm việc trên các tài liệu không? Lý do bạn không thể làm cả hai nên được đưa vào tài khoản bằng câu trả lời.
Steve Jessop

@DocBrown Trong trường hợp này, đó là tài liệu người dùng. Tài liệu mã nguồn sẽ chỉ hữu ích với tôi.
gian mạng

Câu trả lời:


45

Đơn giản: Phát hành phiên bản beta! Sau đó, khi tài liệu được thực hiện, làm phiên bản cuối cùng của phiên bản mới.

Nếu bạn có người dùng sẵn sàng thử những thứ mới, thì bằng mọi cách hãy tận dụng điều đó. Bạn sẽ nhận được báo cáo lỗi, bạn có thể nhận được câu hỏi của cộng đồng về những điểm khó khăn để bạn biết nơi tập trung vào tài liệu, v.v. Bạn cũng có thể muốn điều chỉnh một số điều dựa trên phản hồi của người dùng, điều này có thể ảnh hưởng đến tài liệu.

Về cơ bản, mọi người đều thắng.


Một lý do để không phát hành sớm là, nếu bạn nghĩ rằng người dùng của bạn sẽ không tiếp nhận "phiên bản beta", thì bạn nên suy nghĩ kỹ về việc thực hiện nó, nhưng đi theo những gì bạn viết, có vẻ như họ sẽ hài lòng về điều đó.

Một lý do khác là, nếu có những khó khăn kỹ thuật về việc thực hiện bản phát hành beta bằng bất kỳ kênh phát hành nào bạn sử dụng. Sau đó, có thể rắc rối hơn đáng để thực hiện các phiên bản beta và bản cuối cùng riêng biệt. Nếu bạn nghĩ rằng phần mềm của bạn đã hoàn tất, thì trong trường hợp này tôi sẽ dựa vào bản phát hành sớm, cập nhật tài liệu khi hoàn tất. Mặt khác, có nguy cơ tài liệu bị trì hoãn, và sau đó toàn bộ bản phát hành bị trì hoãn hoặc cuối cùng bạn phát hành mà không có tài liệu cuối cùng, vì vậy hãy làm ngay bây giờ.


1
Tôi đã làm điều này trong quá khứ cho các công cụ nhỏ rất nhiều lần ... mã được thực hiện, tất cả dường như hoạt động, nhưng đến cuối tuần và tôi không thể bận tâm để hoàn thành tài liệu bây giờ. Tôi chỉ gói nó dưới dạng bản beta và voila, nếu bạn muốn phiên bản mới tệ thì đây là, nếu không, bạn sẽ phải đợi vào cuối tuần tới.
Pimgd

Tôi thực sự đã xem xét một phiên bản beta trước khi tôi hỏi ở đây! Vấn đề với ý tưởng đó là các kênh tôi sử dụng buộc tôi phải viết một ứng dụng hoàn toàn riêng biệt để có các bản phát hành tách. Tôi đã bắt đầu làm việc với một phiên bản beta riêng biệt, nhưng hậu cần của nó rất khó khăn và dường như nó không xứng đáng ở giai đoạn này của dự án.
gian mạng

Thay vào đó, những gì tôi đã chọn để làm với tính năng này là biến nó thành bản beta chọn tham gia trong một bản phát hành bình thường. Điều này đảm bảo rằng những người muốn có trải nghiệm ổn định sẽ giữ nó và những người muốn tính năng mới có thể sử dụng nó, với kiến ​​thức rằng đôi khi nó có thể bị hỏng. Sau đó, trong một bản phát hành trong tương lai, tôi có thể chuyển tính năng từ chọn tham gia sang tích hợp, loại bỏ chỉ định beta và tất cả đều tốt trên thế giới.
gian mạng

3
Apache sử dụng "Ứng cử viên phát hành" để đánh dấu một dự án đã hoàn thành về mặt chức năng, nhưng chỉ cần xác thực gói có tất cả các tài nguyên và nó thực sự sẵn sàng cho thời gian chính. Âm thanh như bạn vượt quá giai đoạn beta (chức năng trưởng thành nhưng vẫn chưa hoàn thành).
Berin Loritsch

@BerinLoritsch Tôi đã thấy rằng được sử dụng trước đây. Nhãn đó thực sự phù hợp trong trường hợp này. Tôi đoán việc đưa một tính năng chọn tham gia vào một bản phát hành bình thường là (trong trường hợp của tôi) giống như một ứng cử viên phát hành. Nó ổn định, nó hoạt động, nhưng nó chưa nhìn thấy ánh sáng.
gian mạng

15

Nếu tôi hiểu bạn đúng, bạn đang thực hiện dự án này vào thời gian rảnhkhông có tiền . Nếu đây là trường hợp, xin vui lòng, hãy làm những gì khiến bạn cảm thấy tốt hơn (người dùng chờ đợi, tài liệu về thời gian của bạn). Bạn không nên cảm thấy áp lực từ "người dùng" của mình. Nhiều người đã viết về điều này trên Internet (Các tác giả và cộng tác viên FLOSS lớn, những người cảm thấy áp lực).

Nhưng, nếu bạn được trả tiền, hoặc bạn nhận được một số lợi ích, vui lòng làm những gì người dùng của bạn muốn. Điều này có nghĩa là làm bất cứ điều gì tốt nhất cho khách hàng hoặc người dùng của bạn , trong trường hợp đó, chỉ cần phát hành nó và ghi lại thời gian của bạn. Bạn nói rằng họ sẽ tìm đường xung quanh, vì vậy nó không phải là một vấn đề lớn.


Bạn hiểu đúng rồi! Đây là một buổi biểu diễn không được trả tiền. Nhưng tôi có một số lợi ích, vì tôi là một trong những người dùng quyền lực mà tôi đã nói đến. : P Những gì bạn nói có ý nghĩa, mặc dù, và tôi đánh giá cao câu trả lời của bạn!
gian mạng

4

Nói chung, có hai loại tài liệu: kỹ thuật ghi lại mã của bạn (các lớp, đơn vị, v.v.) và cách các tính năng mới có thể hoạt động và được triển khai trong mã và tài liệu người dùng. IMO, tài liệu kỹ thuật là điều bắt buộc đặc biệt nếu phát triển phần mềm không phải là công việc toàn thời gian của bạn. Tôi dành nhiều thời gian cho việc này vì tôi có thể có những khoảng thời gian viết mã lớn do các cam kết trong cuộc sống.

Tài liệu người dùng là tốt để có nhưng tôi không cần thiết. Tất nhiên, nó phụ thuộc vào mức độ phức tạp của ứng dụng, sự quen thuộc của cơ sở người dùng với việc sử dụng máy tính và hệ thống trong lĩnh vực chủ đề trong cuộc thảo luận - trong trường hợp của bạn, có vẻ như khách hàng của bạn có thể nắm bắt được cách các tính năng mới hoạt động. Có một trường phái cho rằng kinh nghiệm người dùng tốt và giao diện người dùng tốt đòi hỏi tài liệu người dùng tối thiểu.

Ngoài ra, nếu thời gian của bạn bị hạn chế và bạn thực sự cảm thấy áp lực khi phát triển tài liệu như bạn đề xuất, bạn có thể tạo một vài video ngắn giới thiệu các tính năng mới. Điều này sẽ mua cho bạn một chút thời gian để viết tài liệu thực tế và sau đó bạn có thể điền vào các chi tiết ít quan trọng hơn.

Một số mẹo tiếp thị có thể cho phép bạn cân bằng kỳ vọng của người dùng và vẫn thúc đẩy thương hiệu của bạn. Nó thực sự phụ thuộc vào loại ứng dụng và quy trình công việc bạn đã tạo cho đến nay, nhưng bạn có thể có màn hình chào mừng tới phiên bản mới và trong ứng dụng, bạn có thể hiển thị video bằng cách cung cấp liên kết hoặc bằng cách phát video bên trong ứng dụng.


3

Chỉ để thêm một cái gì đó không chỉ cho ví dụ cụ thể này mà cho quy trình công việc chung:

Tài liệu có thể là của bạn definition of done, nhưng tài liệu hầu hết thời gian vượt quá một sản phẩm khả thi tối thiểu (MVP).

Không chỉ là khách hàng luôn luôn đúng. Nếu nó là một sản phẩm thương mại, phát hành có thể có nhiều giá trị kinh doanh và là một ưu tiên tuyệt đối.

Chủ sở hữu xác định giá trị doanh nghiệp (mà bạn nghĩ là bạn), vậy sản phẩm nào có giá trị hơn cho khách hàng của bạn?

Ngoài ra có bất kỳ rủi ro phát hành mà không có tài liệu?

Ví dụ như cạnh tranh ; Nếu đối thủ phát hành siêu tính năng này trước bạn, bạn có thể sẽ mất một số người dùng.

Hãy tự hỏi mình hoặc chủ sở hữu sản phẩm những câu hỏi này và câu trả lời của bạn sẽ rõ ràng.


2

Các tính năng mới làm cho người dùng cũ hài lòng. Tài liệu tốt mời người dùng mới. Những gì bạn nên tập trung vào phụ thuộc vào những gì bạn cần nhiều hơn. Bạn đã chỉ ra rằng cơ sở người dùng đã khỏe mạnh để các tính năng mới có thể chờ. Nói như một người dùng cũ, tôi cũng thích tài liệu tốt. Điều hay về nguồn mở: người dùng cũ thêm các tính năng của riêng họ.


2
Tài liệu tốt chỉ mời người dùng mới nếu tài liệu đó thực sự tồn tại.
Robert Harvey

@robertharvey Một cơ sở người dùng hiện tại đã được chỉ định. Vì vậy, tôi cho rằng họ đang sử dụng một số bản beta chưa được phát hành hoặc cái gì đó khác.
candied_orange

Có một bản phát hành hiện có, mà từ âm thanh của nó được coi là ổn định mặc dù chưa được ghi chép đầy đủ.
jpmc26

2

Bạn chưa làm rõ trong câu hỏi của mình và có thể không cho người dùng biết hậu quả của những lựa chọn này. Bạn dành bao nhiêu thời gian cho hỗ trợ người dùng? Tài liệu bổ sung sẽ giảm lượng thời gian bạn dành cho hỗ trợ hoặc tăng doanh số? Lợi thế để bạn làm tài liệu là gì?

Người dùng của bạn muốn các tính năng mới trên tài liệu, nhưng họ có nhận ra rằng có thể có sự giảm khả dụng của bạn để cung cấp hỗ trợ, sửa lỗi, phát hành bản vá, v.v.?

Nếu tôi không muốn đọc hướng dẫn khi tất cả những gì tôi phải làm là gửi cho bạn một email với câu hỏi của tôi, tại sao tôi lại muốn có tài liệu về các tính năng mới?


-1

Nếu gói đã sẵn sàng để phát hành, hãy phát hành cho khách hàng / khách hàng và bắt đầu làm việc trên tài liệu. Đó là giao tiếp tốt với khách hàng, khi bạn sẽ chia sẻ tài liệu giúp họ hiểu các tính năng được triển khai.

Khi sử dụng trang web của chúng tôi, bạn xác nhận rằng bạn đã đọc và hiểu Chính sách cookieChính sách bảo mật của chúng tôi.
Licensed under cc by-sa 3.0 with attribution required.