การสร้างข้อตกลงสําหรับนักเขียนด้านเทคนิค

ระยะปัจจุบัน:
เผยแพร่กรณีศึกษาแล้ว ดูไทม์ไลน์

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

ขอบเขตของงาน

  • สร้างรายการผลงานที่อยู่ภายใต้ข้อตกลงของคุณ โปรดระบุให้เฉพาะเจาะจงที่สุด ตัวอย่างเช่น แทนที่จะใช้ "เอกสารประกอบ API" ให้สร้างรายการเกี่ยวกับสิ่งที่ต้องจัดทำเอกสารประกอบเกี่ยวกับปลายทาง และข้อมูลที่ต้องระบุ เช่น ตัวอย่างคําสั่ง curl หรือรายการพารามิเตอร์
  • คุณจะทำอย่างไรจึงจะทราบว่าเนื้อหา "เสร็จสมบูรณ์" แล้ว
  • สิ่งอื่นๆ ที่ควรพิจารณา
    • ใครจะเป็นเจ้าของลิขสิทธิ์ในผลงาน เนื้อหาจะเผยแพร่ภายใต้ใบอนุญาตใด (ใบอนุญาตเหล่านี้แตกต่างกัน) นักเขียนเนื้อหาทางเทคนิคจะได้รับเครดิตอย่างไร (การพูดถึงในเว็บไซต์ การระบุเป็นผู้มีส่วนร่วม ฯลฯ) จะเกิดอะไรขึ้นหากต้องขอใบอนุญาตใช้เนื้อหาอีกครั้งในอนาคต ตัวอย่างเช่น หากคุณต้องการให้ผู้เขียนเนื้อหาทางเทคนิคลงนามในข้อตกลงอนุญาตให้ใช้สิทธิของผู้มีส่วนร่วมในโปรเจ็กต์โอเพนซอร์ส คุณควรแจ้งให้ทราบ
    • หากคุณต้องการให้นักเขียนเนื้อหาทางเทคนิคมีส่วนร่วมในการแก้ไขหลายรอบ ให้ระบุไว้อย่างชัดเจน เช่น คุณอาจระบุว่าต้องการฉบับร่างฉบับแรก จากนั้นให้ตรวจสอบครั้งที่ 2 เพื่อแก้ไขปัญหาทางเทคนิค แล้วตรวจสอบครั้งสุดท้ายเพื่อตรวจทาน
    • หากคุณต้องการให้นักเขียนเนื้อหาทางเทคนิคส่งเนื้อหาในรูปแบบที่เฉพาะเจาะจง เช่น Markdown ให้ระบุข้อมูลนี้ไว้ในข้อตกลง
    • โปรเจ็กต์ของคุณมีหลักเกณฑ์ในการใช้ Generative AI เพื่อสร้างเอกสารประกอบหรือโค้ดไหม อย่าลืมแชร์หลักเกณฑ์ดังกล่าวกับนักเขียนเนื้อหาทางเทคนิค

ค่าตอบแทน

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

การสื่อสาร

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

เครื่องมือ

  • นักเขียนเนื้อหาทางเทคนิคต้องใช้เครื่องมือ (หรือเครื่องมือเวอร์ชันใด) ใดบ้างในการสร้างงาน
  • ใครมีหน้าที่รับผิดชอบในการช่วยนักเขียนเนื้อหาทางเทคนิคในการตั้งค่า รับสิทธิ์ หรือรับสิทธิ์เข้าถึง

การแก้ไขความขัดแย้ง

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