ระยะปัจจุบัน:
โปรแกรม Season of Docs ปี 2019 จบลงแล้วเมื่อวันที่ 6 มีนาคม 2020 ดูไทม์ไลน์
หน้านี้จะมีแนวทางสำหรับองค์กรโอเพนซอร์สเกี่ยวกับวิธีประเมินข้อเสนอโครงการเขียนเชิงเทคนิคและเลือกโครงการที่องค์กรต้องการเป็นที่ปรึกษาใน Season of Docs
เกริ่นนำ
นักเขียนด้านเทคนิคส่งข้อเสนอซีซันของเอกสารเพื่อทำงานในโปรเจ็กต์ร่วมกับองค์กรโอเพนซอร์สที่ได้รับเลือก ผู้ดูแลระบบโปรแกรมของ Google ส่งต่อข้อเสนอไปยังองค์กรโอเพนซอร์สเพื่อการประเมินและการเลือกโครงการ โปรดดูรายละเอียดขั้นตอนที่เกี่ยวข้องในคู่มือผู้ดูแลระบบขององค์กร
การประเมินข้อเสนอด้านเทคนิคสำหรับนักเขียน
ทักษะและประสบการณ์ในการเขียนเชิงเทคนิค
ตรวจสอบประสบการณ์ที่ผ่านมาของผู้เขียนด้านเทคนิค ข้อเสนอของนักเขียนด้านเทคนิคมีข้อมูลเกี่ยวกับประสบการณ์การเขียนเชิงเทคนิคครั้งล่าสุดของพวกเขา โดยหลักการแล้ว ผู้สมัครควรมีประสบการณ์เขียนเอกสารทางเทคนิคสำหรับอุตสาหกรรมซอฟต์แวร์มาบ้างแล้ว เป้าหมายอย่างหนึ่งสำหรับ Season of Docs คือการให้โอกาสนักเขียนด้านเทคนิคได้มีส่วนร่วมกับผลิตภัณฑ์นักพัฒนาซอฟต์แวร์โดยเฉพาะ ด้วยเหตุผลนี้ ผู้เขียนจึงไม่จำเป็นต้องมีประสบการณ์เกี่ยวกับ API หรือ SDK หรือแพลตฟอร์มอื่นๆ ของนักพัฒนาซอฟต์แวร์ แม้ว่าโปรเจ็กต์ของคุณจะมุ่งเน้นที่กลุ่มเป้าหมายที่เป็นนักพัฒนาซอฟต์แวร์ก็ตาม
มุ่งเน้นทักษะด้านภาษาและการสื่อสาร ประเมินข้อเสนอของผู้เขียนด้านเทคนิคจากมุมมองนี้ สิ่งที่สำคัญที่สุด คือคุณทำความเข้าใจสิ่งที่ผู้สื่อข่าวเขียนไว้ไหม ในฐานะที่ปรึกษา บทบาทของคุณจะช่วยนักเขียนด้านเทคนิคเกี่ยวกับกระบวนการ เครื่องมือ และโค้ดแบบโอเพนซอร์ส คุณไม่ต้องคอยทบทวนข้อความของเอกสารที่ได้ หากต้องการตรวจสอบภาษาของข้อเสนออย่างละเอียด ให้มองหาความสอดคล้องกันในการใช้เครื่องหมายวรรคตอนและวลี การสะกดคำที่ถูกต้อง และใช้ภาษาที่ชัดเจน วลีเรียบง่ายหรือซับซ้อน ประโยคที่สั้นกระชับหรือเล่นไปเรื่อยๆ จนทำให้ทำตามได้ยาก
ใส่ใจเรื่องการออกแบบและเลย์เอาต์เอกสาร นักเขียนด้านเทคนิคมีโอกาสแสดงตัวอย่างเอกสารที่ตนพัฒนาขึ้น ซึ่งเป็นส่วนหนึ่งของข้อเสนอ ดูเลย์เอาต์โดยรวมของตัวอย่างเอกสาร การออกแบบนี้สมเหตุสมผลไหม ไปยังส่วนต่างๆ ในเอกสารหรือชุดเอกสารได้ง่ายไหม มีเนื้อหาที่ซ้ำกัน หรือช่องว่างที่เด่นชัดไหม
ข้อเสนอ
ตรวจสอบว่าข้อเสนอตรงกับข้อกำหนดของคุณ ข้อเสนอนี้เชื่อมโยงกับไอเดียโปรเจ็กต์ที่คุณส่ง สำหรับฤดูกาลของเอกสารในปีนี้หรือไม่ หากนักเขียนด้านเทคนิคเสนอแนวคิดใหม่ ให้ตรวจสอบว่าข้อเสนอนั้นเหมาะกับความต้องการของโครงการโอเพนซอร์สของคุณไหม และคุณมีบุคลากรที่เหมาะสมเพื่อช่วยผู้เขียนด้านเทคนิคให้บรรลุเป้าหมายของโครงการที่เสนอ
มองหาความกระตือรือร้นและละเอียดถี่ถ้วน ข้อเสนอนี้แสดงให้เห็นว่านักเขียนด้านเทคนิคตื่นเต้นกับโครงการนี้หรือไม่ พิจารณาว่าพวกเขาได้คิดและทุ่มเทให้กับข้อเสนอ ไม่ว่าจะด้วยการปรึกษากับองค์กรในขั้นตอนการสำรวจ หรือการเพิ่มความเห็นของตนเองเกี่ยวกับวิธีบรรลุเป้าหมายของโครงการ
คำถามที่พบบ่อย
เราตัดสินใจเลือกจำนวนโปรเจ็กต์ที่จะส่งได้อย่างไร
มุ่งเน้นที่ 1 หรือ 2 โปรเจ็กต์ หากองค์กรมีศักยภาพในการเป็น Mentor มากกว่านั้น คุณก็ส่งเพิ่มได้ สำหรับโครงการของนักเขียนด้านเทคนิคแต่ละโครงการ คุณต้องมีที่ปรึกษาอย่างน้อย 1 คน (แนะนำ 2 คน) ที่พร้อมจะให้คำปรึกษาเฉพาะโครงการนั้น
อ่านข้อมูลเกี่ยวกับวิธีการจัดสรรช่องสำหรับซีซันของเอกสาร
เราจะเลือกข้อเสนอการเขียนทางเทคนิคที่จะยอมรับได้อย่างไร
โปรดตรวจสอบว่าคุณได้เลือกข้อเสนอของนักเขียนด้านเทคนิคที่ดีที่สุดที่คุณได้รับแล้ว นั่นคือ เลือกข้อเสนอที่เหมาะกับความต้องการของคุณมากที่สุด และตรงกับหลักเกณฑ์การประเมินที่ระบุไว้ข้างต้นมากที่สุด