Submitted by mk on 14 July, 2008 - 16:21
ลองสั่ง generate สร้างสารบัญของหนังสือ Drupal ขึ้นมา เพื่อดูภาพรวมว่ามันหน้าตาเป็นอย่างไร วิธีการเรียงบท ลำดับหัวเรื่องถูกต้องแค่ไหน หัวข้อครอบคลุมเพียงพอหรือเปล่า พบว่าเขียนไปถึง 300 กว่าหน้า A4!!!
ส่วนที่ต้องแก้ไข
- จัดระดับ header ผิดนิดหน่อย
- ตั้งชื่อบทหรือหัวเรื่องไม่ค่อยสื่อความหมาย เวลาอ่านเฉพาะหัวเรื่อง (เช่น ว่าที่ลูกค้ามาพลิกๆ ดูในสารบัญ) แล้วไม่เข้าใจว่าหมายถึงอะไร คงต้องตั้งชื่อบทกันใหม่
ใครอยากดูก็เชิญตามสะดวก: drupal-toc.odt
หมายเหตุ: เพิ่งเคยใช้ฟีเจอร์ Master Document ก็วันนี้ เจ๋งมากมาย
Submitted by mk on 9 July, 2008 - 17:52
หลายๆ คนคงรู้ว่าผมกำลังเขียนหนังสือ Drupal อยู่ ตอนนี้ก็เขียนได้จนมีเนื้อหาพอสมควรระดับหนึ่ง สิ่งที่เรียนรู้จากงานนี้คือการเขียนหนังสือคู่มือแบบนี้เป็นเรื่องยากมาก เพราะคนเขียนต้องจำลองตัวเองเป็นคนที่ไม่รู้อะไรเกี่ยวกับเรื่องที่เขียนเลย และต้องนำทางคนอ่านเข้าสู่โลกของมัน ด้วยการเล่าเรื่องแบบ serialize คือตามบทไปเรื่อยๆ (ซึ่งต่างกับตอนเรียนเอง ที่ใช้วิธีโดดไปโดดมา แล้วเอามาประกอบกันในหัว)
เพื่อคุณภาพของหนังสือ ผมเลือกใช้วิธีของ Eric S. Raymond จาก The Cathedral and the Bazzar
given enough eyeballs, all bugs are shallow
