มือใหม่ (อีกแล้วเหรอ) หัดใช้ PHPDocumentor

เรื่องมีอยู่ว่า ตอนนี้ผมกำลังทำ Framework สำหรับ Web application development อยู่ครับ
และตระหนักว่างาน Document ไม่ใช่งานเล็ก ๆ เพราะต้องทำให้ Programmer ทั้งองค์กรทำความเข้าใจและทำงานด้วย Framework นี้ได้
(พูดเหมือนว่ามีคนเยอะมาก... แต่ก็เอาเถอะ เดี๋ยวก็เยอะเองแหล่ะ ทำไว้ก่อนน่าจะดี อิอิ)

จึงเป็นเหตุให้ต้องลองหาวิธีการทำ Source code document ที่มีประสิทธิภาพ ไม่ต้องการเขียนอะไรซ้ำซ้อน ฯลฯ สรุปว่าหาแบบดี ๆ หน่ะ
และผมเป็นพวกชอบเผื่อไว้ว่าอยากจะแก้ไขอะไรเอง จึงชอบหา project Opensource มาใช้งาน ซึ่งเมื่อลองหาดูก็พบที่ค่อนข้างถูกใจอยู่ 2 ตัวคือ

Doxygen (http://www.doxygen.org) และ phpDocumentor (http://www.phpdoc.org)

แต่ผมเป็นพวกไม่ชอบ compile และอยากให้ติดตั้งได้ง่าย ๆ หน่อย ใช้ command-line ก็พอ Doxygen จึงตกไป
จึงได้เริ่มต้นศึกษาวิธีเขียน Document โดยใช้ phpdoc ณ บัดนี้

-- To be continue --