คู่มือของการทำคู่มือ · ทำตามทีละสเต็ปได้เลย
ร่างเนื้อหา manual จาก spec/screenshot ได้เร็ว
เว็บไซต์คู่มือ [เติม: เราเลือกอันไหน]
ฟอร์แมตเนื้อหา ใช้ได้ทั้งสอง platform
screenshot หน้าจริงทุกสเต็ป · spec/OpenAPI/BA · ชื่อ field/status/error จริง · ตัวอย่างเล่มเดิม (ให้ AI เลียนโทน)
⚠️ AI เขียนดี = input ดี อย่าให้ AI เดา
ใช้ template จาก Prompt Library (หัวข้อ คลัง Prompt) → เลือกอันที่ตรงงาน → เติมข้อมูลจริง → ส่ง
เช็กตาม checklist ข้างล่างทุกครั้ง ห้าม copy ตรง ๆ ลงเว็บ
แก้จุดที่ AI พลาด · ปรับโทนให้ตรงเล่มอื่น · เพิ่มภาพ/ลิงก์จริง
Docusaurus: สร้าง docs/หมวด/หน้า.mdx → frontmatter (title, sidebar_position) → เนื้อหา → ถ้าใช้ HTML card ต้อง format:'mdx'
Astro (Starlight): สร้าง src/content/docs/ → frontmatter (title, description) → เนื้อหา
[เติม: path จริง repo เรา + คำสั่ง sync spec]
npm run start / npm run dev ดู local → npm run build เช็ก build ผ่าน
[เติม: วิธี deploy จริง — Vercel / GitHub Pages / อื่น ๆ]
| อาการ | วิธีจับ | วิธีแก้ |
|---|---|---|
| มโน UI ที่ไม่มีจริง | เทียบ screenshot | ให้ screenshot ประกอบเสมอ |
| ใช้ชื่อ field ผิด/เดาเอง | เทียบ spec | ระบุชื่อจริงใน prompt |
| ข้ามขั้น edge case | ลองทำตามจริง | สั่งให้ครอบ error case |
MDX syntax พัง (< {}) | build fail | escape / ใช้ code block |
| โทนไม่ตรงเล่มเดิม | อ่านเทียบ | ให้ตัวอย่างเล่มเดิมใน prompt |
| [เติมของจริงที่เราเจอ] | ||
กำหนดความยาว + โครงสร้างใน prompt (ดูหัวข้อ คลัง Prompt)
มักเป็น MDX syntax — เช็ก < { } ที่ไม่ได้ escape