คู่มือผู้ดูแลระบบองค์กร

ระยะปัจจุบัน:
ประกาศผล ไทม์ไลน์

คู่มือนี้มีไว้สำหรับผู้ดูแลระบบองค์กรที่สมัครหรือเข้าร่วมโปรแกรมซีซันของเอกสาร

องค์กรของคุณควรเข้าร่วมโปรแกรม 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)

 ดูไทม์ไลน์