ระยะปัจจุบัน:
ประกาศผล
ไทม์ไลน์
คู่มือนี้มีไว้สำหรับผู้ดูแลระบบองค์กรที่สมัครหรือเข้าร่วมโปรแกรมซีซันของเอกสาร
องค์กรของคุณควรเข้าร่วมโปรแกรม Season of Docs หรือไม่
ใช้คำถามเหล่านี้เพื่อช่วยให้คุณเข้าใจว่าโครงการโอเพนซอร์สหรือองค์กรของคุณควรเข้าร่วมใน Season of Docs หรือไม่
องค์กรหรือโครงการของคุณมีลักษณะดังนี้
- เชื่อว่าเอกสารใหม่หรือเอกสารที่อัปเดตจะช่วยให้บรรลุเป้าหมายหรือแก้ไขปัญหาในโปรเจ็กต์หรือชุมชนได้
- มีความเข้าใจเบื้องต้นหรือสมมติฐานเกี่ยวกับวิธีวัดความสำเร็จของโปรเจ็กต์เอกสารประกอบหรือไม่
- หากสมาชิกชุมชนต้องการช่วยสรรหา ประเมิน และเตรียมความพร้อมสำหรับนักเขียนด้านเทคนิค และใครที่พอจะช่วยตอบคำถามและให้การสนับสนุนอื่นๆ ในระหว่างโครงการ (6-8 เดือน รวมถึงระยะเวลาการสมัคร)
- หากมีสมาชิกชุมชนที่ต้องการทำหน้าที่เป็นผู้ดูแลระบบองค์กรและประสานงานในการสร้างแอปพลิเคชัน ตอบคำถามจากผู้ดูแลระบบโปรแกรม และส่งการประเมินรายเดือนและการประเมินผลขั้นสุดท้ายและกรณีศึกษา นอกจากนี้ ผู้ดูแลระบบขององค์กรควรยินดีตอบแบบสำรวจติดตามผลหลังสิ้นสุดฤดูกาลของโปรแกรมเอกสาร
นอกจากนี้ องค์กรของคุณควรมีคุณสมบัติตามข้อกำหนดของการได้รับสิทธิ์เข้าร่วมโปรแกรม รวมถึงสามารถสร้างบัญชี Open Collective ได้
ขั้นตอนการสมัครขององค์กร
ขั้นตอนการสำรวจ
แม้ว่าใบสมัครใช้งาน Season of Docs จะเปิดในวันที่ 23 กุมภาพันธ์ 2022 แต่เราขอแนะนำเป็นอย่างยิ่งให้องค์กรต่างๆ ใช้เวลาทำตามขั้นตอนการสำรวจให้เสร็จสมบูรณ์ก่อนที่จะส่งใบสมัคร
- สร้างหน้าข้อเสนอโครงการ หน้าข้อเสนอมีรายการของความต้องการสำคัญ เป้าหมาย หรือปัญหา วิธีแก้ปัญหาเอกสารที่เป็นไปได้ และเมตริกที่เป็นไปได้ หน้านี้ควรเป็นแบบสาธารณะ และอนุญาตให้ชุมชน สนับสนุนและอภิปรายข้อมูลได้ ใส่ข้อมูลสำหรับนักเขียนด้านเทคนิคที่ต้องการเข้าร่วม เขาควรถามคำถาม แสดงความสนใจ หรือไปดูข้อมูลเพิ่มเติมเกี่ยวกับโปรเจ็กต์ของคุณจากที่ใด เราขอแนะนำให้คุณเพิ่มที่อยู่อีเมลสำหรับติดต่อ องค์กรโอเพนซอร์สของคุณเกี่ยวกับ Season of Docs อย่างไรก็ตาม เราขอแนะนำอย่างยิ่งไม่ให้ใช้อีเมลส่วนตัวเป็นอีเมลสำหรับติดต่อองค์กรโอเพนซอร์สของคุณ (ดูตัวอย่างได้ที่รายการแนวคิดโปรเจ็กต์)
- เผยแพร่หน้าข้อเสนอในช่องของชุมชนและเพิ่มองค์กรของคุณลงในรายชื่อองค์กรที่สนใจในซีซันของที่เก็บใน GitHub ของเอกสาร นอกจากนี้ คุณยังอาจต้องแชร์ลิงก์ในช่อง #Season-of-docs ในหัวข้อเขียน Slack ของเอกสารด้วย หน้าโปรโมชันและข่าวมีโลโก้และเนื้อหาอื่นๆ ที่คุณสามารถใช้เมื่อพูดถึงซีซันของเอกสาร
- สำหรับแนวคิดเกี่ยวกับเอกสารประกอบแต่ละแนวคิด ให้พิจารณาประสบการณ์และคุณสมบัติที่นักเขียนด้านเทคนิคต้องการเพื่อทำงานร่วมกับชุมชนและองค์กรของคุณให้ประสบความสำเร็จ ทักษะใดที่ชุมชนของคุณจะช่วยนักเขียนด้านเทคนิคได้ (เช่น การใช้ GitHub หรือ Toolchain ของเอกสาร) (ดูคำแนะนำในการทำงานกับนักเขียนด้านเทคนิค
- ขออาสาสมัครที่จะช่วยตอบคำถามจากนักเขียนด้านเทคนิคที่สนใจ
- เริ่มตรวจสอบข้อความที่สนใจที่ส่งมาจากนักเขียนด้านเทคนิคที่สนใจทำงานร่วมกับโครงการของคุณ
ขั้นตอนการสมัคร
- เลือกแนวคิดที่ดีที่สุดจากหน้าข้อเสนอของคุณ แต่ละองค์กรจะส่งข้อเสนอได้เพียง 1 ข้อเท่านั้น ข้อควรพิจารณามีดังนี้
- ไอเดียใดได้รับความสนใจจากนักเขียนด้านเทคนิคมากที่สุด
- แนวคิดใดจะช่วยแก้ปัญหาที่ใหญ่ที่สุดของโปรเจ็กต์ของคุณ ขอแนะนำให้คุณเลือกแนวคิดที่มีความเสี่ยงมากกว่าซึ่งจะมีผลกระทบมากกว่าแนวคิดสำหรับโครงการเอกสารที่มีแนวโน้มจะเสร็จสมบูรณ์ แต่จะไม่สร้างความแตกต่างที่มีนัยสำคัญกับโครงการ
- ความคิดนั้นต้องการให้สมาชิกเฉพาะในชุมชนเข้ามามีส่วนร่วม หรือไม่ พวกเขามีเวลาเข้าร่วมไหม
สร้างข้อเสนอโดยใช้เทมเพลตข้อเสนอ ตรวจสอบว่าคุณเข้าใจและระบุข้อมูลต่อไปนี้
- ปัญหาที่ต้องการแก้ไข
- ขอบเขตของเอกสารที่ต้องการปรับปรุงหรือสร้าง
- วิธีวัดความสำเร็จของเอกสาร
ข้อเสนอของคุณต้องมีงบประมาณด้วย ข้อเสนอที่ไม่สมบูรณ์จะไม่ได้รับการพิจารณา
ส่งแบบฟอร์มการสมัครภายในวันที่ 25 มีนาคม 2022 เวลา 18:00 น. (UTC) และจะประกาศข้อเสนอที่ยอมรับในวันที่ 14 เมษายน 2022
การพัฒนาและการรายงานโครงการ
การเริ่มต้นโปรเจ็กต์
- หากองค์กรได้เลือกนักเขียนด้านเทคนิคให้โครงการแล้ว ให้จัดการประชุมเบื้องต้นกับผู้เขียนด้านเทคนิค คุณควรทำงานร่วมกับนักเขียนด้านเทคนิคเพื่อจัดตารางงานและนัดมาพูดคุยกันเป็นประจำ
- หากคุณได้รับข้อความหลายข้อความที่สนใจจากนักเขียนด้านเทคนิคที่สนใจ โปรดประกาศต่อสาธารณะเกี่ยวกับการคัดเลือกนักเขียนด้านเทคนิคหรือแจ้งผู้สมัครเกี่ยวกับการตัดสินใจของคุณ
การชำระเงินโดยอนุมัติ
- ฤดูกาลเอกสารจะฝากเงิน 40% ของงบประมาณสนับสนุนให้กับบัญชี Open Collective ของแต่ละองค์กรหลังจากจ้างนักเขียนด้านเทคนิค โดยเริ่มตั้งแต่วันที่ 9 มิถุนายน 2022 เราขอแนะนำให้องค์กรสร้างกำหนดการชำระเงินร่วมกับผู้เขียนด้านเทคนิคโดยอิงตามเหตุการณ์สำคัญของโครงการ รวมถึงการชำระเงินเมื่อเริ่มต้นโครงการ
- ส่วนอีก 60% ที่เหลือจะฝากเข้าบัญชี Open Collective ขององค์กรที่ทำและส่งการประเมินขั้นสุดท้ายและกรณีศึกษาจะเริ่มตั้งแต่วันที่ 14 ธันวาคม 2022 โปรดทราบว่าโปรเจ็กต์ที่ประสบความสําเร็จทั้งหมด (เช่น โปรเจ็กต์ 3 เดือนเทียบกับโปรเจ็กต์ 6 เดือน) จะเริ่มได้รับเงินครั้งสุดท้ายในวันที่ 14 ธันวาคม 2022 ไม่ว่าโปรเจ็กต์จะอยู่ในระยะเวลาไหนก็ตาม
- ดูคู่มือการชำระเงินสำหรับข้อมูลเพิ่มเติม เกี่ยวกับการสร้างบัญชี Open Collective
การรายงานสถานะโปรเจ็กต์
- ผู้ดูแลระบบองค์กรควรกรอกรายงานสถานะรายเดือนภายใน 1 สัปดาห์หลังจากได้รับลิงก์ไปยังแบบฟอร์มรายงานสถานะ (ลิงก์จะส่งให้ทางอีเมล ดังนั้นโปรดตรวจสอบโฟลเดอร์จดหมายขยะ)
การประเมินขั้นสุดท้ายของโปรเจ็กต์และกรณีศึกษา
องค์กรต้องทำและส่งทั้งการประเมินขั้นสุดท้ายของโปรเจ็กต์และกรณีศึกษาก่อนวันที่ 30 พฤศจิกายน 2022 เวลา 18:00 น. ตามเขตเวลา UTC เพื่อรับเงินสนับสนุนที่เหลือ
การประเมินขั้นสุดท้าย
ผู้ดูแลระบบองค์กรจะใช้แบบฟอร์มประเมินขั้นสุดท้ายได้ภายในวันที่ 30 พฤศจิกายน 2022 เวลา 18:00 น. ตามเขตเวลา UTC
กรณีศึกษา
กรณีศึกษา Season of Docs เป็นสิ่งสำคัญที่ส่งมอบสำหรับการมีส่วนร่วมขององค์กรใน Season of Docs การเก็บบันทึกการอัปเดตโครงการรายสัปดาห์ จะช่วยให้คุณสร้างกรณีศึกษาได้ ในแต่ละสัปดาห์ ให้บันทึกความคืบหน้าของโปรเจ็กต์ (รวมถึงลิงก์สำหรับดึงคำขอ ปัญหา หรือการสนทนา ในกรณีที่เป็นประโยชน์) สิ่งที่ทำได้ดี (หรือไม่ดี) สิ่งที่ได้เรียนรู้ และคำถามที่ถาม
โปรดอ่านการสร้างกรณีศึกษาเพื่อดูข้อมูลเพิ่มเติมและปฏิบัติตามเทมเพลตกรณีศึกษาเพื่อสร้างกรณีศึกษา คุณจะส่งกรณีศึกษาเป็นลิงก์ในแบบฟอร์มการประเมินขั้นสุดท้าย
กรณีศึกษาของคุณจะถูกเผยแพร่ในเว็บไซต์ Season of Docs โปรดคำนึงถึงเรื่องนี้ด้วยเมื่อระบุข้อมูลเกี่ยวกับโปรเจ็กต์ของคุณ
เรากำหนดให้องค์กรต่างๆ เข้าร่วมทำแบบสำรวจติดตามผลอย่างน้อย 3 รายการเพื่อช่วยติดตามความสำเร็จของโครงการ Season of Docs เมื่อเวลาผ่านไป
แบบฟอร์ม
| แบบฟอร์ม | ลิงก์ | กำหนดเวลา |
|---|---|---|
| ใบสมัครขององค์กร | ตอนนี้เราปิดรับสมัครแล้ว เข้าร่วมรายชื่ออีเมลของประกาศที่ season-of-docs-announce เพื่อให้ทราบข้อมูลอยู่เสมอ |
25 มีนาคม 2022 เวลา 18:00 น. (UTC) |
| ข้อมูลการชำระเงินขององค์กร | แบบฟอร์มนี้ยังไม่พร้อมใช้งาน |
วันที่ 12 พฤษภาคม 2022 เวลา 18:00 น. UTC |
| หลักฐานการว่าจ้างนักเขียนด้านเทคนิค | ขั้นตอนการว่าจ้างนักเขียนด้านเทคนิคเสร็จสมบูรณ์แล้ว |
16 พฤษภาคม 2022 เวลา 18:00 น. UTC |
| การประเมินรายเดือน | ช่วงการประเมินประจำเดือนได้สิ้นสุดลงแล้ว |
ดูไทม์ไลน์ |
| การประเมินโครงการขั้นสุดท้ายและกรณีศึกษา | ช่วงการประเมินโปรเจ็กต์ได้สิ้นสุดลงแล้ว |
30 พฤศจิกายน 2022 เวลา 18:00 น. UTC |
| แบบสำรวจติดตามผล | แบบฟอร์มจะใช้ได้ในช่วงทำการสำรวจติดตามผล (2 พฤษภาคม 2023) |
ดูไทม์ไลน์ |