ระยะปัจจุบัน:
โปรแกรม Season of Docs ปี 2021 สิ้นสุดลงแล้วเมื่อวันที่ 14 ธันวาคม 2021 ดูไทม์ไลน์
ใช้ตัวอย่างนี้เพื่อช่วยสร้างรายงานกรณีศึกษาของคุณเอง
PicklePlus: เอกสารประกอบเกี่ยวกับเครื่องมือการมีส่วนร่วมของ GloriousPickle
องค์กรหรือโปรเจ็กต์: Glorious Pickle ลิงก์ไปยังเว็บไซต์หลักขององค์กรหรือโปรเจ็กต์ของคุณที่นี่
คําอธิบายองค์กร: GloriousPickle (เวอร์ชันปัจจุบันคือ 1.2.3 เผยแพร่ครั้งแรกในปี 2009) เป็นคลังที่ได้รับอนุญาตจาก MIT ที่ช่วยคํานวณสัดส่วนที่เหมาะสมของเกลือ น้ำตาล น้ำส้มสายชู และเครื่องเทศสําหรับผักทุกชนิดที่ทําให้เปรี้ยวได้ ไม่ว่าจะมีปริมาณมากน้อยเพียงใด ตั้งแต่แตงกวาขี้เหร่มเพียงลูกเดียวไปจนถึงหัวไชเท้าเต็มตู้คอนเทนเนอร์
ผู้เขียน: ไม่บังคับ: ระบุรายชื่อผู้เขียนของกรณีศึกษา ใช้ชื่อผู้ใช้หากมีการขอ
ข้อความแจ้งปัญหา/ข้อมูลสรุปของข้อเสนอ
คุณพยายามแก้ปัญหาอะไรด้วยเอกสารประกอบใหม่หรือที่ปรับปรุงแล้ว ลิงก์ไปยังหน้าโปรเจ็กต์ในเว็บไซต์ของคุณ (หากเป็นไปได้)
การเพิ่มส่วนผสมลงในฐานข้อมูลส่วนผสมของเครื่องมือ GloriousPickle นั้นใช้เวลานานและซับซ้อน และเครื่องมือไม่มีเอกสารประกอบที่ดี ผู้ที่ต้องการมีส่วนร่วมหลายคนไม่มีประสบการณ์ในการใช้ git หรือการส่งคำขอดึงข้อมูล ซึ่งหมายความว่า GloriousPickle มีช่องโหว่ร้ายแรงในข้อมูลส่วนผสมของเรา และทำให้เครื่องมือของเรามีประโยชน์น้อยลง การปรับปรุงเอกสารประกอบสำหรับการเพิ่มส่วนผสมใหม่จะช่วยให้ผู้มีส่วนร่วมใหม่ๆ เข้ามามีส่วนร่วมและมีการดองมากขึ้น
คำอธิบายโปรเจ็กต์
การสร้างข้อเสนอ
คุณคิดข้อเสนอซีซันของเอกสารได้อย่างไร องค์กรของคุณใช้กระบวนการใดในการตัดสินใจเกี่ยวกับไอเดีย คุณขอและนําความคิดเห็นไปใช้อย่างไร
SIG ของ GloriousPickle PickleDocs ได้ยินเกี่ยวกับโปรแกรม Season of Docs ผ่านทวีตจากสำนักงานโปรแกรมโอเพนซอร์สของ Google SIG ได้พูดคุยเกี่ยวกับโปรแกรมนี้ในการประชุมทุก 2 สัปดาห์ และตกลงที่จะสร้างข้อเสนอ สมาชิก SIG 2 คน (@KimChiCook และ @Dillicious) อาสาที่จะทำงานเกี่ยวกับร่างข้อเสนอเพื่อตรวจสอบในการประชุมครั้งถัดไป
เมื่อ SIG ของ PickleDocs เห็นด้วยกับร่างข้อเสนอแล้ว ก็ส่งอีเมลไปยังโปรเจ็กต์ในวงกว้างเพื่อขอความคิดเห็น สมาชิกชุมชน 14 คนแสดงความคิดเห็น ซึ่งรวมถึง @Glorious PicklePat ซึ่งเป็นผู้ดูแล ingredient-adding API @GloriousPicklePat อาสาเป็นทรัพยากรในระหว่างโปรแกรม
หลังจากพูดคุยและนำความคิดเห็นที่ได้รับมาใช้แล้ว ระบบก็ส่งข้อเสนอไปให้ Glorious Pickle Project Steering Committee ในการลงคะแนนเสียงเลือกตั้ง สมาชิกทั้ง 5 รายของ GPPSC ได้โหวต +1 ในการส่งข้อเสนอและใบสมัคร และ @VinegarViv ตกลงที่จะช่วยสร้างบัญชี Open Collective ที่จำเป็นสำหรับการเข้าร่วมโปรแกรมและดูแลการชำระเงิน
งบประมาณ
ใส่ส่วนสั้นๆ เกี่ยวกับงบประมาณ คุณประเมินงานอย่างไร มีค่าใช้จ่ายที่ไม่คาดคิดไหม คุณได้ใช้จ่ายน้อยกว่าเงินรางวัลที่ได้รับหรือไม่ คุณมีเครดิตอื่นๆ นอกเหนือจาก Season of Docs ที่ใช้ได้ไหม
สมาชิก 2 คนของ GloriousPickle PickleDocs SIG เคยทำงานเป็นนักเขียนด้านเทคนิค (1 คนอยู่ในยุโรปและอีก 1 คนอยู่ในอาร์เจนตินา) ทีมนี้ช่วยเราประเมินงานและหางบประมาณโปรเจ็กต์ที่คล้ายกัน โดยเปรียบเทียบกับงานร่างข้อเสนอที่เคยทำไว้ก่อนหน้านี้ นอกจากนี้ เรายังมีเงินสนับสนุนแบบไม่จํากัดมูลค่า 1,000 USD เหลืออยู่จากการประชุม PicklePals ปี 2019 ซึ่งเราจัดสรรให้กับโปรเจ็กต์นี้
ค่าใช้จ่ายที่ไม่คาดคิดคือการช่วยเหลือผู้เขียนเทคนิคของเราให้เช่าฮอตสปอต Wi-Fi เนื่องจากผู้เขียนอาศัยอยู่ในพื้นที่ที่ได้รับผลกระทบจากไฟป่าและอินเทอร์เน็ตที่บ้านใช้งานไม่ได้ ท้ายที่สุด เราส่งเสื้อยืดให้ผู้เข้าร่วมน้อยกว่าที่วางแผนไว้ ดังนั้นจึงมีความสมดุล
นอกจากนี้ เรายังตัดสินใจที่จะชดเชยเงินให้ @Piccalily ผู้มีส่วนร่วมใน GloriousPickle (ซึ่งเคยเป็นบรรณาธิการข้อความมืออาชีพมาก่อน) เพื่อช่วยในการแก้ไขข้อความและพิสูจน์อักษรเอกสารประกอบที่นักเขียนเทคนิคเขียน
ผู้เข้าร่วม
ใครทำงานในโปรเจ็กต์นี้ (ใช้ชื่อผู้ใช้หากผู้เข้าร่วมขอ) คุณค้นหาและจ้างผู้เขียนเนื้อหาทางเทคนิคได้อย่างไร คุณพบอาสาสมัครหรือผู้เข้าร่วมแบบชำระเงินคนอื่นๆ ได้อย่างไร พวกเขามีบทบาทอะไรบ้าง มีใครหยุดเข้าร่วมไหม คุณได้เรียนรู้อะไรบ้างเกี่ยวกับการสรรหาบุคลากร การสื่อสาร และการจัดการโครงการ
ทีมหลักที่ทำงานในโปรเจ็กต์นี้ ได้แก่
- @Dillicious, @KimChiCook (PickleDocs SIG)
- @Piccalily (ผู้ตรวจแก้)
- @GherKen, @VinegarViv (ความช่วยเหลือจากผู้ดูแลระบบ, GPPSC)
- @BBChips, @GloriousPicklePat (ผู้เชี่ยวชาญด้านเนื้อหา)
- Sam Scribe (นักเขียนด้านเทคนิค)
เราพบ Sam Scribe ผ่านรายการที่เก็บ GitHub ของ Season of Docs เราคิดว่าประสบการณ์ของ Sam (Sam เคยทำงานให้กับนิตยสารการทำอาหารและเขียนเอกสารประกอบสำหรับเว็บไซต์) เหมาะกับโปรเจ็กต์ของเรา Sam เข้าร่วมการโทร SIG ของ PickleDocs ทุก 2 สัปดาห์และพูดคุยเกี่ยวกับโปรเจ็กต์กับเรา รวมถึงให้คำแนะนำที่มีคุณค่ามากมายซึ่งเราได้นำไปใช้ในข้อเสนอ นอกจากนี้ เรายังได้ติดต่อนักเขียนด้านเทคนิคอีก 2 คนที่เรารู้จักผ่านเครือข่ายของสมาชิก SIG แต่ทั้ง 2 คนไม่สะดวกให้ความร่วมมือในช่วงเวลาของโปรแกรม
เนื่องจากเขตเวลาของ Sam ทับซ้อนกับเขตเวลาของสมาชิกส่วนใหญ่ของ SIG ของ PickleDocs เพียงไม่กี่ชั่วโมง เราจึงส่งคำขอในฟอรัมการสนทนาสำหรับ Picklers ที่อยู่ในเขตเวลาของ Sam และที่คุ้นเคยกับกระบวนการเพิ่มส่วนผสม @BBChips อาสาตอบคำถามให้ Sam และช่วยค้นหาผู้เชี่ยวชาญคนอื่นๆ ตามความจำเป็น นอกจากนี้ @GloriousPicklePat ยังอาสาช่วย Sam ทำความเข้าใจสถาปัตยกรรมพื้นฐานของเครื่องมือและข้อความแสดงข้อผิดพลาดที่อาจเกิดขึ้นจาก API รวมถึงให้ความช่วยเหลือเกี่ยวกับ GitHub และ git
ขออภัยที่ @VinegarViv ต้องถอนตัวจากโปรเจ็กต์นี้ด้วยเหตุผลส่วนตัวในช่วงกลางโปรแกรม สมาชิก GPPSC @GherKen เข้ามาช่วยตอบคำถามเกี่ยวกับการดูแลระบบและการชำระเงิน
หลังจากพลาดคำถามไปบ้าง (GloriousPickle ใช้อินสแตนซ์ Slack แบบไม่มีค่าใช้จ่าย และบางครั้งการสนทนาก็ดำเนินไปอย่างรวดเร็วจนเราพลาดการสนทนาไปเนื่องจากขีดจำกัดของการเก็บถาวรแบบเลื่อน) เราจึงพบว่าควรเก็บรายการคำถามที่ดำเนินอยู่ไว้ในเอกสารที่แชร์ (เราใช้ Google เอกสารที่แชร์) สมาชิก SIG ของ PickleGoogle ได้ตรวจสอบเอกสารดังกล่าวก่อนการประชุมแต่ละครั้งและตรวจสอบว่าได้รับคำตอบก่อนสิ้นสุดการประชุม Sam สามารถส่งข้อความถึง @BBChips โดยตรงสำหรับคำถามเร่งด่วน
เราดีใจมากที่ได้ร่วมงานกับ Sam และ Sam นอกเหนือจากการอัปเดตเอกสารของ Glorious Pickle แล้ว ก็ยังกลายมาเป็นนักเลือกตัวยงอีกด้วย
ไทม์ไลน์
ให้ภาพรวมสั้นๆ เกี่ยวกับไทม์ไลน์ของโปรเจ็กต์ (ระบุวันที่สิ้นสุดโดยประมาณหรือเป้าหมายขั้นกลางหากโปรเจ็กต์ยังดำเนินอยู่)
ในขณะที่เรารอให้โปรแกรม Season of Documents ประกาศถึงองค์กรที่เข้าร่วม สมาชิก SIG ของ PickleDocument ได้ทำการค้นหางานที่เราคิดว่าจะเป็นประโยชน์สำหรับ Sam ตลอดระยะเวลา 1 เดือนที่ผ่านมา เราพบโน้ตบางส่วนจากความพยายามก่อนหน้านี้ในการอัปเดตเอกสารประกอบที่หยุดชะงัก และเราได้ดำเนินการกับเนื้อหาบางส่วนของการตรวจสอบความพร้อมใช้งานของเอกสารประกอบใน Google OpenDocs Repository ด้วย
เมื่อได้รับข่าวดีว่าเราได้รับเลือกให้เข้าร่วม Season of Docs ประจำปี 2021 แล้ว Sam และ SIG ของ PickleDocs ได้ประชุมกันเพื่อกำหนดเวลาคร่าวๆ ดังนี้
ระยะทำงาน | เสร็จสมบูรณ์โดย |
---|---|
ตรวจสอบเอกสาร | 7 พฤษภาคม |
กรณีการใช้งาน 3 กรณีของบันทึกความเสียดทาน | 14 พฤษภาคม |
ตรวจสอบบันทึกการขัดข้องกับ @GloriousPicklePat และ @BBChips รวมถึงตอบคำถาม | 28 พฤษภาคม |
ฉบับร่างแรกของ Use Case เอกสารที่อัปเดต 1 | 25 มิถุนายน |
ฉบับร่างของกรณีการใช้งาน 1 ที่ตรวจสอบโดย @Glorious PicklePat และ @KimChiCook | 2 กรกฎาคม |
ฉบับร่างแรกของ Use Case เอกสารที่อัปเดต 2 | 2 กรกฎาคม |
ฉบับร่างกรณีการใช้งานที่ 2 ตรวจสอบโดย @Glorious PicklePat และ @Dilliious | 9 กรกฎาคม |
ฉบับร่างแรกของ Use Case เอกสารที่อัปเดต 3 | 9 กรกฎาคม |
Use case 3 draft reviewed by @Dillicious & @KimChiCook | 16 กรกฎาคม |
ตอบคำถามทั้งหมดใน Use Case ทั้งหมด | 30 กรกฎาคม |
SIG ของ PickleDocs ส่วนใหญ่หยุดพักร้อนตั้งแต่วันที่ 1-20 ส.ค. | -- |
เริ่มการทดสอบเอกสารใหม่ในชุมชน (เอกสารที่เผยแพร่เป็นฉบับร่างในเว็บไซต์ GloriousPickle) | 21 สิงหาคม |
รวบรวมความคิดเห็นสำหรับการทดสอบแล้ว | 10 กันยายน |
แก้ไขและพิสูจน์อักษรเอกสารใหม่ | 17 กันยายน |
นำสถานะ "ฉบับร่าง" ของเอกสารออกแล้ว เอกสารเปิดตัวอย่างเป็นทางการ | 28 กันยายน |
กระบวนการอัปเดตเอกสารประกอบที่สร้างขึ้น | 1 พฤศจิกายน |
กรณีศึกษานี้สร้างขึ้น | 8 พฤศจิกายน |
ส่งกรณีศึกษาแล้ว | 16 พฤศจิกายน |
ในงบประมาณของข้อเสนอ เราคาดการณ์ว่าผู้เขียนเนื้อหาทางเทคนิคจะใช้เวลา 10-15 ชั่วโมงต่อสัปดาห์ในการทำงานในโปรเจ็กต์ สมชายเก็บบันทึกเวลาที่ใช้โดยเฉลี่ยอยู่ที่ 11.5 ชั่วโมงต่อสัปดาห์
ผลลัพธ์
สิ่งที่สร้าง อัปเดต หรือมีการเปลี่ยนแปลง ใส่ลิงก์ไปยังเอกสารที่เผยแพร่ หากมี มีชิ้นงานใดในข้อเสนอที่ไม่ได้สร้างขึ้นไหม แล้วระบุรายการเหล่านั้นไว้ด้วย
เราได้จัดทำเอกสารกรณีการใช้งานหลัก 3 กรณีพร้อมคู่มือผู้ใช้แบบสมบูรณ์ ดังนี้
วิธีเพิ่มส่วนผสมใหม่ลงใน GloriousPickle
วิธีเพิ่มส่วนผสมของรายละเอียดปลีกย่อยลงใน Glorious Pickle
วิธีอัปเดตหรือแก้ไขส่วนผสมใน GloriousPickle
คู่มือเหล่านี้ยังมีเทมเพลตคำขอดึงข้อมูลใหม่เพื่อให้คุณมีส่วนร่วมได้ง่ายขึ้นด้วย
นอกจากนี้ ในระหว่างที่ทำงานในโปรเจ็กต์ Sam ได้สร้างอภิธานศัพท์ขนาดเล็กเกี่ยวกับ Pickle ขึ้น ซึ่งได้เผยแพร่ไว้ในเว็บไซต์ของโปรเจ็กต์ GloriousPickle ด้วย
เราได้เพิ่มวิธีการอัปเดตคู่มือวิธีการสำหรับผู้ใช้เหล่านี้ลงในวิกิของโปรเจ็กต์
เราได้รวมการสร้างเคล็ดลับสำหรับผู้มีส่วนร่วมที่เพิ่งเริ่มใช้ GitHub เพื่อช่วยให้ผู้มีส่วนร่วมใช้กระบวนการและเครื่องมือของเราได้ แต่เมื่อพิจารณาแหล่งข้อมูลที่มีอยู่แล้ว เราพบว่าเราสามารถแยกข้อมูลเคล็ดลับของโปรเจ็กต์อื่นมาแทนได้
เมตริก
คุณเลือกเมตริกใดในการวัดความสำเร็จของโครงการ คุณรวบรวมเมตริกเหล่านั้นได้ไหม เมตริกมีความเกี่ยวข้องกับผลลัพธ์ที่ต้องการในโปรเจ็กต์มากหรือน้อยเพียงใด เมตริกมีการเปลี่ยนแปลงนับตั้งแต่การเสนอราคาไหม
ในข้อเสนอของเรา เราได้เสนอเมตริก 2 รายการ ได้แก่
- จำนวนคำขอดึงข้อมูลที่เกี่ยวข้องกับส่วนผสม
- จำนวนคำขอดึงข้อมูลจากผู้มีส่วนร่วมใหม่
ในเดือนกันยายน (เดือนแรกเต็มนับตั้งแต่การเผยแพร่เอกสารประกอบฉบับร่าง) เราพบว่าคำขอดึงข้อมูลเกี่ยวกับส่วนผสมเพิ่มขึ้น 5% (จากวันที่ 20 ในเดือนสิงหาคมเป็นวันที่ 21 เดือนกันยายน) และเราพบผู้ร่วมให้ข้อมูลใหม่ 3 รายที่ส่งคำขอดึงข้อมูลทั้งหมด 4 รายการ (เทียบกับผู้ร่วมให้ข้อมูลใหม่ 2 รายที่ส่งคำขอดึงข้อมูล 2 รายการในเดือนสิงหาคม) เราวางแผนที่จะติดตามเมตริกเหล่านี้ทุกเดือน
ตั้งแต่วันที่ 1 มกราคมเป็นต้นไป เราจะติดตามจำนวนผู้มีส่วนร่วมที่มีส่วนร่วมมากกว่า 3 ครั้งโดยรวม โดยจะเริ่มทุกไตรมาสหลังจากที่เผยแพร่เอกสารประกอบ
เราเชื่อว่าเอกสารประกอบใหม่นี้ช่วยเปิดโอกาสให้ผู้มีส่วนร่วมรายใหม่ๆ เพิ่มข้อมูลลงในฐานข้อมูลส่วนผสมของ GloriousPickle ได้ และผู้มีส่วนร่วมรายใหม่รายหนึ่งได้พูดถึงในความคิดเห็นของ PR ว่าเคยลองทำแล้ว แต่อัปเดตไม่เสร็จเพราะไม่เข้าใจกระบวนการ
การวิเคราะห์
มีอะไรบ้างที่เป็นไปด้วยดี มีอะไรที่ไม่คาดคิดบ้าง คุณพบอุปสรรคหรือความล่าช้าอะไรบ้าง คุณคิดว่าโปรเจ็กต์ของคุณประสบความสำเร็จหรือไม่ เพราะเหตุใด (หากยังบอกไม่ได้ ให้อธิบายว่าเมื่อใดที่คุณคาดว่าจะตัดสินได้ว่าโปรเจ็กต์ประสบความสำเร็จหรือไม่)
เรายินดีอย่างยิ่งกับผลลัพธ์ของโปรเจ็กต์ Season of Docs และถือว่าโปรเจ็กต์นี้ประสบความสำเร็จ เอกสารประกอบใหม่นี้ชัดเจนและเป็นประโยชน์ และเราได้เห็นจำนวนคำขอดึงข้อมูลที่เกี่ยวข้องกับส่วนผสมและจำนวนคำขอดึงข้อมูลจากผู้มีส่วนร่วมรายใหม่เพิ่มขึ้นแล้ว
เรายังดีใจที่ชุมชน Glorious Pickle เกือบทั้งหมดมีส่วนร่วมผ่านการแสดงความคิดเห็นเกี่ยวกับข้อเสนอต้นฉบับและการทดสอบเอกสารใหม่ในแบบฟอร์มฉบับร่าง
เราพบอุปสรรคที่ไม่คาดคิด 2-3 อย่าง และรู้สึกขอบคุณที่ไฟป่าในรัฐของ Sam ไม่ได้สร้างความเสียหายมากกว่าการหยุดทำงานของอินเทอร์เน็ต และเสียใจด้วยที่เสีย @VinegarViv ไปจากโครงการนี้ เราอวยพรให้เธอและครอบครัวของเธอประสบความสำเร็จ และหวังว่าจะได้พบเธออีกในเร็วๆ นี้
สิ่งที่เราไม่รู้ตัวจนกระทั่ง Sam เริ่มจัดทำเอกสารประกอบคือคำศัพท์และคำย่อที่เกี่ยวข้องกับการดองจำนวนมากที่ผู้ใช้ใหม่ในโปรเจ็กต์ซึ่งไม่มีพื้นฐานด้านการดองอาจไม่คุ้นเคย อย่างไรก็ตาม Sam จดรายการคำที่ไม่คุ้นเคยไว้ทุกคำและหาคำจำกัดความผ่านการศึกษาด้วยตนเอง รวมถึงขอคำอธิบายและข้อมูลอ้างอิงจากสมาชิกชุมชน พจนานุกรมศัพท์เกี่ยวกับผักดองนี้จะช่วยได้มากในการต้อนรับผู้คนจำนวนมากขึ้นสู่ชุมชนการดองผักในอนาคต
สรุป
สรุปประสบการณ์ในโปรเจ็กต์ของคุณใน 2-4 ย่อหน้า ไฮไลต์สิ่งที่ได้เรียนรู้และสิ่งที่คุณเลือกที่จะทําต่างออกไปในอนาคต คุณจะให้คำแนะนำอะไรกับโปรเจ็กต์อื่นๆ ที่พยายามแก้ปัญหาที่คล้ายกันเกี่ยวกับเอกสารประกอบ
พูดสั้นๆ ก็คือ ประสบการณ์ของเรานั้นยอดเยี่ยมมาก เราส่งเอกสารประกอบตามกำหนดการและเมตริกของเราดูเหมือนจะสอดคล้องกับเป้าหมาย
ความสำเร็จของโปรเจ็กต์นี้ส่วนหนึ่งมาจากความโชคดีของเราที่ได้ร่วมงานกับ Sam Scribe นักเขียนด้านเทคนิค [ฉันไม่ได้เขียนข้อความนี้ - Sam] แม้ว่า Sam จะไม่มีพื้นฐานด้านการเก็บรักษาหรือประสบการณ์เกี่ยวกับ GitHub แต่ในฐานะนักเขียนเนื้อหาทางเทคนิคที่มีประสบการณ์ Sam ก็พร้อมที่จะเจาะลึกหัวข้อใหม่ ถามคำถาม และทําการวิจัย Sam เรียนรู้เครื่องมือสำหรับโปรเจ็กต์ (เราใช้ Kanban Board เพื่อติดตามงาน) และมุกตลกเกี่ยวกับแตงกวาได้อย่างรวดเร็ว เราดีใจมากที่แซมเจอข้อบกพร่องในการดองและเราได้ 'ขวด' พวกเขาในชุมชนของเรา
เราขอแนะนําให้โปรเจ็กต์อื่นๆ ทําดังนี้
- เขียนข้อเสนอให้สั้นและจัดการได้ง่าย (เดิมเราต้องการใส่เอกสารประกอบสำหรับการใช้เครื่องมือประเมินของเรากับเครื่องหมักดองแบบเป็นชุดอุตสาหกรรมไว้ในข้อเสนอ แต่ไม่ได้ใส่ไว้เนื่องจากสมาชิกชุมชนของเราคนหนึ่งซึ่งมีส่วนร่วมอย่างมากในเครื่องหมักดองแบบโอเพนซอร์สกำลังจะเขียนวิทยานิพนธ์ระดับปริญญาเอกระหว่างเข้าร่วมโปรแกรมนี้) สุดท้ายแล้ว Sam ก็มีงานทำไม่ขาดมือ
- ใช้ประโยชน์จากเครือข่ายของคุณเมื่อมองหาผู้เขียนเนื้อหาทางเทคนิค ขอคำแนะนำจากทุกคนในชุมชน แม้ว่าเราจะพบ Sam ผ่าน GitHub ของ Season of Docs แต่เราก็มั่นใจที่จะร่วมงานกับ Sam เนื่องจากเราได้พูดคุยกับหลายๆ คนในช่วงสมัคร
- ยินดีต้อนรับนักเขียนเนื้อหาทางเทคนิคสู่ชุมชน Sam แจ้งให้เราทราบว่าทัศนคติที่กระตือรือร้นของ GloriousPicklers ทำให้เขาถามคำถามได้อย่างง่ายดาย
- ช่วยให้นักเขียนเนื้อหาทางเทคนิคมีทักษะด้านโอเพนซอร์ส Sam ไม่เคยใช้ git มาก่อน แต่หลังจากดูบทแนะนำ 2-3 บท ก็เริ่มใช้งานได้อย่างรวดเร็ว ตอนแรก Sam กังวลว่าจะได้รับความคิดเห็นจากชุมชนมากน้อยเพียงใดและจะนำความคิดเห็นเหล่านั้นไปใช้อย่างไร แต่รูปแบบ "ความเห็นพ้องแบบคร่าวๆ" ของชุมชน ("ความเห็นพ้องเกิดขึ้นเมื่อปัญหาทั้งหมดได้รับการแก้ไขแล้ว แต่ไม่จำเป็นต้องรองรับ") ทำให้ Sam มั่นใจในการรับมือกับการวิจารณ์โดยใช้ความเชี่ยวชาญด้านการเขียนเชิงเทคนิค
ภาคผนวก
หากคุณมีสื่ออื่นๆ ที่ต้องการลิงก์ไป (เช่น หากคุณสร้างสัญญาการทำงานร่วมกับนักเขียนด้านเทคนิคที่ต้องการแชร์ เทมเพลตสำหรับโครงการจัดทำเอกสาร หรือทรัพยากรอื่นๆ สำหรับเอกสารแบบเปิด คุณสามารถระบุรายการและลิงก์เหล่านั้นได้ที่นี่) นอกจากนี้ ส่วนภาคผนวกยังเป็นตําแหน่งที่ดีในการระบุลิงก์ไปยังเครื่องมือหรือแหล่งข้อมูลเอกสารประกอบที่คุณใช้ หรือเป็นตําแหน่งที่จะเพิ่มคําขอบคุณหรือคําขอบคุณที่อาจไม่เหมาะกับส่วนด้านบน
บริการรับรองคำให้การ
ทีมของเราต้องการกล่าวขอบคุณบุคคลและสิ่งต่อไปนี้
- @Dillicious ขอขอบคุณพาร์ทเนอร์และ low-fi hip hop radio
- @KimChiCook อยากขอบคุณ 할머 ที่สอนวิธีหมักดองให้เขาเอง
- @Piccalily ขอขอบคุณ Chicago Manual of Style Online
- @GherKen อยากขอบคุณลูกๆ ทั้ง 3 คนกินผักดองทุกอย่างที่เขาทำได้
- @VinegarViv อยากขอบคุณคนอื่นๆ ของทีมที่ช่วยอำนวยความสะดวกให้คุณในการลงจากตำแหน่ง
- @BBChips ขอขอบคุณอาหารที่ไม่ใช้ผักดองที่ดีที่สุดอย่างเวเฟอร์คาราเมลของ Tunnock
- @GloriousPicklePat ขอขอบคุณ SIG ของ PickleDocs ที่รับโปรเจ็กต์นี้
- Sam Scribe ขอขอบคุณชุมชน GloriousPickle ทุกคน โดยเฉพาะเหล่า Picklers ที่ส่งกระป๋องบรรจุอาหารมาให้ในช่วงที่กระป๋องขาดแคลนในช่วงฤดูร้อนปี 2021 ซึ่งทำให้เขาเริ่มทำอาหารดองที่แสนอร่อยได้