หน้านี้มีรายละเอียดของโครงการการเขียนเชิงเทคนิคที่ยอมรับสำหรับ Google Season of Docs
ข้อมูลสรุปของโปรเจ็กต์
- องค์กรโอเพนซอร์ส:
- GraphQL
- ผู้เขียนด้านเทคนิค:
- carolstran
- ชื่อโปรเจ็กต์:
- สร้างแหล่งข้อมูลสำหรับคำถามที่พบบ่อย
- ระยะเวลาของโปรเจ็กต์:
- ระยะเวลามาตรฐาน (3 เดือน)
คำอธิบายโปรเจ็กต์
การเรียนรู้เทคโนโลยีใหม่นั้นไม่ใช่เรื่องง่าย และมาพร้อมกับคำถามมากมาย การใช้ GraphQL ทำให้โครงการพัฒนาไปมากเพียงพอและส่วนใหญ่มีข้อมูลอยู่แล้ว หาได้ไม่ยากเพราะข้อมูลนั้นอยู่กระจัดกระจายอยู่ในแหล่งข้อมูลและชุมชนการเขียนโปรแกรมที่หลากหลาย
สิ่งที่อาจช่วยปรับปรุงเครื่องมือสำหรับผู้เรียน GraphQL ได้ก็คือส่วนคำถามที่พบบ่อย (FAQ) ส่วนกลาง ปัจจุบันข้อมูลนี้ขาดหายไปจาก Graql.org และนำไปสู่คำถามที่ซ้ำๆ อย่างต่อเนื่องหรือไม่ได้รับคำตอบ
ส่วนคำถามที่พบบ่อยใหม่นี้จะถูกนำไปผสานรวมในเว็บไซต์ Graql.org และประกอบด้วยส่วนต่างๆ ที่เกี่ยวข้องกับสิ่งต่อไปนี้
ประวัติและภายใน GraphQL
- GraphQL Foundation คืออะไร
- GraphQL สร้างขึ้นเมื่อใดและเพราะเหตุใด
- แหล่งข้อมูลที่ดีที่สุดสำหรับการเริ่มต้นใช้งานคืออะไร
ข้อมูลเบื้องต้นเกี่ยวกับ GraphQL
- GraphQL และ REST/SQL/ฯลฯ แตกต่างกันอย่างไร
- กรณีการใช้งาน GraphQL ที่ดีที่สุดคืออะไร
- GraphQL มีไว้สำหรับนักพัฒนาซอฟต์แวร์ของ React เท่านั้นใช่ไหม
แนวคิด GraphQL ขั้นสูง
- คุณจะแคชฝั่งเซิร์ฟเวอร์ด้วย GraphQL ได้อย่างไร
- GraphQL รองรับการใช้งานแบบออฟไลน์ไหม
- คุณจะทดสอบ GraphQL API ได้อย่างไร
ข้อมูลจำเพาะ
- ฉันจะมีส่วนร่วมในข้อกำหนดได้อย่างไร
- วิธีใดคือวิธีที่ดีที่สุดในการปฏิบัติตามข้อกำหนดที่เผยแพร่
และฟีเจอร์อื่นๆ จะตามมาในอนาคต คำถามด้านบนเป็นตัวอย่างที่อาจเป็นไปได้ นอกจากนี้ยังเป็นเนื้อหาที่ฉันได้รับการสอบถามจากเพื่อนร่วมงานที่กำลังเรียนรู้หรือหลังจากการสัมมนาเกี่ยวกับ GraphQL ในการประชุม
คำถามสำหรับคำถามที่พบบ่อยจะมาจากพื้นที่ต่างๆ ในอินเทอร์เน็ต จากนั้นจะจัดเรียงและจัดลำดับความสำคัญในภายหลัง ตัวอย่างเช่น
- StackOverflow
- ปัญหาเกี่ยวกับ GitHub (ในองค์กร GraphQL, How To GraphQL และอื่นๆ)
- การสนทนากับผู้สอน GraphQL ที่มีชื่อเสียง
- หน้าผลิตภัณฑ์ที่เกี่ยวข้องกับ GraphQL
- Quora
นอกเหนือจากเนื้อหาที่กระชับและเป็นประโยชน์แล้ว หน้าคำถามที่พบบ่อยในช่วงสุดท้ายจะสร้างขึ้นโดยคำนึงถึง UX และการเข้าถึงเป็นหลัก