ลองสั่ง generate สร้างสารบัญของหนังสือ Drupal ขึ้นมา เพื่อดูภาพรวมว่ามันหน้าตาเป็นอย่างไร วิธีการเรียงบท ลำดับหัวเรื่องถูกต้องแค่ไหน หัวข้อครอบคลุมเพียงพอหรือเปล่า พบว่าเขียนไปถึง 300 กว่าหน้า A4!!!

ส่วนที่ต้องแก้ไข

• จัดระดับ header ผิดนิดหน่อย
• ตั้งชื่อบทหรือหัวเรื่องไม่ค่อยสื่อความหมาย เวลาอ่านเฉพาะหัวเรื่อง (เช่น ว่าที่ลูกค้ามาพลิกๆ ดูในสารบัญ) แล้วไม่เข้าใจว่าหมายถึงอะไร คงต้องตั้งชื่อบทกันใหม่

ใครอยากดูก็เชิญตามสะดวก: drupal-toc.odt

หมายเหตุ: เพิ่งเคยใช้ฟีเจอร์ Master Document ก็วันนี้ เจ๋งมากมาย

หลายๆ คนคงรู้ว่าผมกำลังเขียนหนังสือ Drupal อยู่ ตอนนี้ก็เขียนได้จนมีเนื้อหาพอสมควรระดับหนึ่ง สิ่งที่เรียนรู้จากงานนี้คือการเขียนหนังสือคู่มือแบบนี้เป็นเรื่องยากมาก เพราะคนเขียนต้องจำลองตัวเองเป็นคนที่ไม่รู้อะไรเกี่ยวกับเรื่องที่เขียนเลย และต้องนำทางคนอ่านเข้าสู่โลกของมัน ด้วยการเล่าเรื่องแบบ serialize คือตามบทไปเรื่อยๆ (ซึ่งต่างกับตอนเรียนเอง ที่ใช้วิธีโดดไปโดดมา แล้วเอามาประกอบกันในหัว)

เพื่อคุณภาพของหนังสือ ผมเลือกใช้วิธีของ Eric S. Raymond จาก The Cathedral and the Bazzar

given enough eyeballs, all bugs are shallow

ที่ผ่านมาก็ได้แจกให้กับมิตรสหายไปบ้างจำนวนหนึ่ง และได้ feedback ที่น่าสนใจกลับมาหลายอัน ตอนนี้ก็ถึงเวลาอันสมควรแล้ว คิดว่าได้เวลาแจกจ่ายให้กับผู้สนใจเสียที เงื่อนไขแลกเปลี่ยนคืออ่านจริงไม่ทิ้งขว้าง อ่านให้ละเอียด ถ้าถึงขั้นทำตามได้ก็เจ๋งมาก และสุดท้ายอ่านจบแล้ว “วิจารณ์” กลับมาตามสมควร

(feedback ล็อตแรกหาเจอแม้กระทั่งเครื่องหมาย / ที่ขาดไปในแท็ก <br> ส่วนความยาวเฉลี่ยของคำวิจารณ์ล็อตแรกอยู่ที่ประมาณ 20 bullet points ต่อคน)

ถ้าสนใจก็ลงชื่อพร้อมทั้งอีเมล (ในช่องอีเมลจะได้ไม่โดนสแปม) ไว้ได้เลย

ในอนาคตหนังสือจะเผยแพร่ใต้ Creative Commons อยู่แล้ว ไม่ต้องเป็นห่วงว่าจะไม่มีอ่าน รอบนี้ต้องการเฉพาะผู้ที่สนใจจริงๆ เท่านั้น พวก “เอามาเผื่อไว้ก่อน” อย่าเพิ่งเข้ามา