วางจำหน่ายก่อนหรือเอกสารก่อน?


23

ฉันทำงานโครงการมาสองสามปีแล้วและฉันเริ่มรวบรวมฐานผู้ใช้ที่เหมาะสม ฉันได้สร้างหน้าโครงการด้วยเอกสารพื้นฐานบางอย่าง แต่จริงๆแล้วมันก็ไม่ได้เป็นอะไรมากไปกว่าคำถามที่พบบ่อยในตอนนี้ ฉันรู้ว่าฉันต้องปรับปรุงมันเพื่อให้มีข้อมูลมากขึ้นสำหรับทั้งผู้ใช้ใหม่และผู้ใช้ระดับสูงและนั่นเป็นเรื่องถัดไปในรายการที่ต้องทำของฉันสำหรับการเปิดตัวครั้งถัดไป

อย่างไรก็ตามรุ่นต่อไปมีคุณสมบัติที่ฐานผู้ใช้จะได้รับ ฉันเตรียมที่จะปล่อยมันตอนนี้มันเป็นชุดและพร้อมที่จะไป ฉันแค่ต้องปรับใช้กับบริการจัดจำหน่ายที่เหมาะสม

ตรงประเด็น คุณสมบัติมีความสำคัญต่อผู้ใช้ของฉัน แต่เอกสารเป็นสิ่งสำคัญสำหรับฉัน ฉันควรรอจนกว่าจะปล่อยเอกสารอีกครั้ง? ฐานผู้ใช้ปัจจุบันของฉันเข้าใจเพียงพอที่จะเข้าใจวิธีการใช้คุณสมบัติใหม่ดังนั้นนั่นไม่ใช่สิ่งที่ฉันกังวล อาจต้องใช้เวลาสองสามสัปดาห์กว่าจะเสร็จสิ้นเอกสารเนื่องจากฉันมีเวลา จำกัด ในการทำงานในโครงการนี้ แต่ชุมชนจะย่างฉันด้วยถ่มน้ำลายหากฉันทำให้พวกเขารออีกต่อไป

ลูกค้ามีสิทธิ์ในสถานการณ์นี้หรือไม่ คุณสมบัติที่ยอดเยี่ยมและตรงไปตรงมาสำหรับผู้ใช้ปัจจุบันควรให้ความสำคัญมากกว่าเอกสารที่มีประสิทธิภาพสำหรับผู้ใช้ใหม่หรือไม่?


Update:ว้าวคำตอบที่ยอดเยี่ยมและมีคุณภาพสูงมากมาย! คุณช่วยให้ฉันได้รับความเข้าใจที่ดีขึ้นเกี่ยวกับวิธีการโต้ตอบและการสนับสนุนทั้งโครงการและผู้ใช้ ขอบคุณหนึ่งล้าน!


14
ใช่ลูกค้าถูกต้อง แผ่ออกวางจำหน่ายแล้วใช้เวลาสองสัปดาห์ในการรับเอกสาร คุณได้บอกกับเราแล้วว่าฐานผู้ใช้จะไม่ได้รับผลกระทบจากการขาดเอกสารประกอบและเป็นเพียงอีกสองสัปดาห์ หากนี่คืองานแสดงสินค้าจริงลูกค้าหรือองค์กรของคุณจะย่างคุณในถ่มน้ำลายจริงเพราะสองสัปดาห์โดยไม่มีการเปิดตัวเป็นสองสัปดาห์น้อยกว่าที่จะรวบรวมส่วนแบ่งการตลาด
Robert Harvey

3
ขึ้นอยู่กับโครงการที่คุณอาจปล่อยรุ่นใหม่ในสาขาแยกเป็น "เบต้า" หรือ "ดูตัวอย่าง"
CodesInChaos

2
เอกสารประเภทใด - เอกสารสำหรับผู้ใช้หรือเอกสารเกี่ยวกับรหัสต้นฉบับ? หรือโครงการของคุณบางประเภทที่ไม่มีความแตกต่างระหว่างเหล่านั้นคืออะไร?
Doc Brown

5
ดูเหมือนจะไม่มีความขัดแย้งใด ๆ ที่นี่: ถ้ามันเป็นชุดและพร้อมที่จะไปทำไมคุณไม่สามารถปล่อยมันและทำงานกับเอกสารต่อไปสำหรับการปรับปรุงเอกสารเท่านั้นในสองสัปดาห์? คุณมีความกังวลหรือไม่ว่าการปล่อยจะสร้างงานจำนวนมาก (ในรายงานข้อบกพร่องและอื่น ๆ ) ที่จะป้องกันไม่ให้คุณทำงานกับเอกสาร เหตุผลที่คุณไม่สามารถทำทั้งสองอย่างได้ควรคำนึงถึงคำตอบด้วย
Steve Jessop

@DocBrown ในกรณีนี้เป็นเอกสารสำหรับผู้ใช้ เอกสารรหัสต้นฉบับจะมีประโยชน์สำหรับฉันเท่านั้น
cyberbit

คำตอบ:


45

เรียบง่าย: ปล่อยรุ่นเบต้า! จากนั้นเมื่อมีการจัดทำเอกสารเสร็จแล้วให้ปล่อยเวอร์ชั่นใหม่ขั้นสุดท้าย

หากคุณมีผู้ใช้ที่ต้องการทดลองสิ่งใหม่ ๆ คุณสามารถใช้ประโยชน์จากสิ่งนั้นได้ คุณจะได้รับรายงานข้อผิดพลาดคุณอาจได้รับคำถามเกี่ยวกับชุมชนเกี่ยวกับประเด็นที่ยากดังนั้นคุณจะได้รู้ว่าจะให้ความสนใจกับเอกสารอื่น ๆ ได้อย่างไรนอกจากนี้คุณอาจต้องการปรับแต่งบางสิ่งตามความคิดเห็นของผู้ใช้

โดยพื้นฐานแล้วทุกคนชนะ


เหตุผลหนึ่งที่จะไม่ออกรุ่นแรกคือถ้าคุณคิดว่าผู้ใช้ของคุณจะไม่รับ "รุ่นเบต้า" คุณควรคิดสองครั้งเกี่ยวกับการทำ แต่ทำตามสิ่งที่คุณเขียนดูเหมือนว่าพวกเขาจะมีความสุขกับมัน

อีกเหตุผลหนึ่งคือถ้ามีปัญหาทางเทคนิคเกี่ยวกับการทำรุ่นเบต้าโดยใช้ช่องทางที่คุณใช้ ถ้าอย่างนั้นมันอาจจะยุ่งยากมากกว่าที่ควรจะเป็นรุ่นเบต้าแยกและรุ่นสุดท้าย หากคุณคิดว่าซอฟต์แวร์ของคุณเสร็จสมบูรณ์ดังนั้นในกรณีนี้ฉันจะต้องปล่อยรุ่นก่อนหน้าให้อัปเดตเอกสารเมื่อทำเสร็จ มิฉะนั้นมีความเสี่ยงที่เอกสารจะล่าช้าและจากนั้นการเผยแพร่ทั้งหมดจะล่าช้าหรือคุณปล่อยเอกสารโดยไม่มีเอกสารขั้นสุดท้ายดังนั้นให้ทำทันที


1
ฉันเคยทำสิ่งนี้มาแล้วในอดีตสำหรับเครื่องมือขนาดเล็กหลาย ๆ ครั้ง ... รหัสเสร็จแล้วดูเหมือนว่าทั้งหมดจะทำงานได้ แต่มันเป็นจุดสิ้นสุดของวันหยุดสุดสัปดาห์และฉันไม่สามารถใส่ใจที่จะทำให้เอกสารเสร็จ ฉันเพิ่งบรรจุมันเป็นรุ่นเบต้าและ voila ถ้าคุณต้องการรุ่นใหม่ไม่ดีแล้วนี่คือมิฉะนั้นคุณจะต้องรอวันหยุดสุดสัปดาห์ถัดไป
Pimgd

ฉันคิดว่าเป็นรุ่นเบต้าก่อนที่ฉันจะถามที่นี่! ปัญหาเกี่ยวกับความคิดนั้นคือช่องทางที่ฉันใช้บังคับให้ฉันเขียนแอพที่แยกจากกันอย่างสมบูรณ์เพื่อให้มีการเผยแพร่แยก ฉันเริ่มทำงานสู่รุ่นเบต้าแยกต่างหาก แต่โลจิสติกส์ของมันยากและดูเหมือนว่าจะไม่คุ้มค่าในขั้นตอนของโครงการนี้
cyberbit

สิ่งที่ฉันเลือกจะทำกับคุณสมบัตินั้นคือทำให้มันเป็นเบต้าที่เลือกรับในรุ่นปกติ สิ่งนี้ทำให้แน่ใจได้ว่าผู้ที่ต้องการประสบการณ์ที่มั่นคงจะเก็บมันไว้และผู้ที่ต้องการคุณสมบัติใหม่สามารถใช้งานได้โดยมีความรู้ว่าอาจทำลายได้ในบางครั้ง จากนั้นในการเปิดตัวในอนาคตฉันสามารถย้ายคุณลักษณะจากการเลือกใช้เป็นการรวมเอาการกำหนดรุ่นเบต้าออกและทุกอย่างก็อยู่ในโลกใบนี้
cyberbit

3
Apache ใช้ "Release Candidates" เพื่อทำเครื่องหมายโครงการที่เสร็จสิ้นการใช้งานได้ แต่เพียงตรวจสอบว่าแพ็คเกจมีทรัพยากรทั้งหมดและพร้อมสำหรับช่วงเวลาสำคัญเท่านั้น ดูเหมือนว่าคุณจะเกินกว่าขั้นตอนเบต้า (ฟังก์ชั่นเป็นผู้ใหญ่ แต่ยังไม่สมบูรณ์)
Berin Loritsch

@BerinLoritsch ฉันเคยเห็นที่ใช้มาก่อน จริงๆแล้วฉลากนั้นเข้ากันได้ดีในกรณีนี้ ฉันเดาว่าการวางคุณสมบัติการเลือกใช้ในรุ่นปกติคือ (ในกรณีของฉัน) บางสิ่งบางอย่างเช่นตัวเลือกรุ่น มันใช้งานได้ดี แต่มันยังไม่เห็นแสงสว่าง
cyberbit

15

ถ้าฉันมีคุณขวาคุณกำลังทำโครงการนี้ด้วยตัวคุณมีเวลาว่างและไม่มีเงิน หากเป็นกรณีนี้โปรดทำสิ่งที่ทำให้คุณรู้สึกดีขึ้น (ผู้ใช้รอเอกสารตามเวลาของคุณ) คุณไม่ควรรู้สึกกดดันจาก "ผู้ใช้" ของคุณ หลายคนเขียนเกี่ยวกับสิ่งนี้บนอินเทอร์เน็ต (ผู้เขียน FLOSS ขนาดใหญ่และผู้มีส่วนร่วมที่รู้สึกกดดัน)

แต่ถ้าคุณได้รับเงินหรือได้รับประโยชน์โปรดทำตามที่ผู้ใช้ต้องการ ซึ่งหมายความว่าทำสิ่งที่ดีที่สุดสำหรับลูกค้าหรือผู้ใช้ของคุณในกรณีนั้นเพียงแค่ปล่อยและทำเอกสารให้ตรงเวลา คุณบอกว่าพวกเขาจะหาทางไปรอบ ๆ ดังนั้นจึงไม่ควรเป็นเรื่องใหญ่


คุณเข้าใจถูกต้อง! นี่คือกิ๊กที่ค้างชำระ แต่ฉันจะได้รับประโยชน์เพราะฉันเป็นหนึ่งในผู้ใช้ที่ฉันพูดถึง : P สิ่งที่คุณพูดทำให้รู้สึก แต่และฉันขอขอบคุณคำตอบของคุณ!
cyberbit

4

โดยทั่วไปมีเอกสารสองประเภท: เทคนิคที่เอกสารรหัสของคุณ (คลาสหน่วย ฯลฯ ) และวิธีการทำงานของคุณสมบัติใหม่และการใช้งานในรหัสและเอกสารประกอบของผู้ใช้ IMO เอกสารทางเทคนิคเป็นสิ่งจำเป็นโดยเฉพาะอย่างยิ่งหากการพัฒนาซอฟต์แวร์ไม่ใช่งานประจำของคุณ ฉันใช้เวลากับเรื่องนี้มากเพราะฉันอาจมีช่วงเวลาว่างในการเขียนรหัสเนื่องจากข้อผูกพันในชีวิต

เอกสารสำหรับผู้ใช้นั้นดี แต่ฉันก็ไม่จำเป็น แน่นอนขึ้นอยู่กับความซับซ้อนของแอพพลิเคชั่นความคุ้นเคยของฐานผู้ใช้กับการใช้คอมพิวเตอร์และระบบในหัวข้อการสนทนา - ในกรณีของคุณดูเหมือนว่าลูกค้าของคุณจะเข้าใจถึงคุณลักษณะใหม่ ๆ มีโรงเรียนแห่งความคิดออกมาโต้แย้งว่าประสบการณ์การใช้งานที่ดีและส่วนต่อประสานผู้ใช้ที่ดีนั้นต้องการเอกสารสำหรับผู้ใช้น้อยที่สุด

นอกจากนี้หากเวลาของคุณมี จำกัด และคุณรู้สึกกดดันในการพัฒนาเอกสารตามที่คุณแนะนำคุณสามารถสร้างวิดีโอสั้น ๆ สองสามเรื่องเพื่อแนะนำคุณสมบัติใหม่เท่านั้น สิ่งนี้จะซื้อเวลาให้คุณเขียนเอกสารจริงจากนั้นคุณสามารถกรอกรายละเอียดที่สำคัญน้อยลง

เคล็ดลับการตลาดบางอย่างอาจช่วยให้คุณสร้างความสมดุลให้กับความคาดหวังของผู้ใช้และยังคงช่วยยกระดับแบรนด์ของคุณ มันขึ้นอยู่กับประเภทของแอปพลิเคชันและเวิร์กโฟลว์ที่คุณสร้างขึ้น แต่คุณสามารถมีหน้าจอต้อนรับสู่เวอร์ชันใหม่ของคุณและภายในแอปพลิเคชันคุณสามารถแสดงวิดีโอได้โดยให้ลิงก์หรือเล่นวิดีโอภายในแอป


3

เพียงเพิ่มบางสิ่งบางอย่างไม่เพียง แต่สำหรับตัวอย่างเฉพาะนี้ แต่สำหรับเวิร์กโฟลว์ทั่วไป:

เอกสารอาจเป็นของคุณdefinition of doneแต่เอกสารเป็นส่วนใหญ่เกินกว่าผลิตภัณฑ์ที่มีศักยภาพน้อยที่สุด (MVP)

ไม่เพียง แต่ลูกค้าจะถูกเสมอ หากเป็นผลิตภัณฑ์เชิงพาณิชย์การปล่อยอาจมีมูลค่าทางธุรกิจจำนวนมากและมีความสำคัญอย่างยิ่ง

เจ้าของกำหนดมูลค่าทางธุรกิจ (ซึ่งฉันถือว่าคุณ) ดังนั้นสิ่งที่มีคุณค่ามากขึ้นเป็นผลิตภัณฑ์สำหรับลูกค้าของคุณ?

มีความเสี่ยงใด ๆ ที่ปล่อยโดยไม่มีเอกสารประกอบหรือไม่?

ตัวอย่างเช่นการแข่งขัน ; หากการแข่งขันเปิดตัวคุณสมบัติพิเศษนี้ก่อนที่คุณจะสูญเสียผู้ใช้บางส่วน

ถามตัวคุณเองหรือเจ้าของผลิตภัณฑ์คำถามเหล่านี้และคำตอบของคุณจะชัดเจน


2

คุณสมบัติใหม่ทำให้ผู้ใช้เก่ามีความสุข เอกสารที่ดีเชิญผู้ใช้ใหม่ สิ่งที่คุณควรมีสมาธินั้นขึ้นอยู่กับว่าคุณต้องการอะไรมากกว่านี้ คุณระบุว่าฐานผู้ใช้มีสุขภาพดีเพื่อให้คุณสมบัติใหม่สามารถรอได้ พูดเป็นผู้ใช้เก่าฉันชอบเอกสารที่ดีเช่นกัน สิ่งดีๆเกี่ยวกับโอเพ่นซอร์ส: ผู้ใช้เก่าเพิ่มคุณสมบัติของตัวเอง


2
เอกสารที่ดีจะเชิญผู้ใช้ใหม่เท่านั้นหากเป็นเอกสารสิ่งที่มีอยู่จริง
Robert Harvey

@robertharvey ฐานผู้ใช้ปัจจุบันถูกระบุ ดังนั้นฉันคิดว่าพวกเขากำลังใช้เบต้าที่ไม่ได้เผยแพร่บางอย่างหรืออย่างอื่น
candied_orange

มีการเปิดตัวที่มีอยู่ซึ่งจากเสียงของมันถือว่ามีเสถียรภาพแม้จะอยู่ภายใต้เอกสาร
jpmc26

2

คุณยังไม่ได้ชี้แจงในคำถามของคุณและอาจไม่ส่งผลต่อตัวเลือกเหล่านี้ให้กับผู้ใช้ของคุณ คุณใช้เวลาเท่าไรในการสนับสนุนผู้ใช้ เอกสารเพิ่มเติมจะลดระยะเวลาที่คุณใช้ในการสนับสนุนหรือเพิ่มยอดขายหรือไม่ อะไรคือข้อดีของการทำเอกสาร?

ผู้ใช้ของคุณต้องการคุณสมบัติใหม่ ๆ บนเอกสาร แต่พวกเขารู้หรือไม่ว่าการมีอยู่ของคุณลดลงเพื่อให้การสนับสนุนแก้ไขข้อบกพร่องแพทช์ปล่อย ฯลฯ

ถ้าฉันไม่อยากอ่านคำแนะนำเมื่อสิ่งที่ฉันต้องทำคือส่งอีเมลพร้อมคำถามของฉันทำไมฉันถึงต้องการเอกสารเกี่ยวกับคุณสมบัติใหม่ ๆ ?


-1

หากแพ็คเกจพร้อมที่จะปล่อยให้ปล่อยให้ลูกค้า / ลูกค้าและเริ่มทำงานกับเอกสาร เป็นการสื่อสารที่ดีกับลูกค้าเมื่อคุณจะแบ่งปันเอกสารซึ่งช่วยให้พวกเขาเข้าใจคุณลักษณะที่ปรับใช้

โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.