基本上個人將要分享出來的文件分為三種型態： 1. 實作指引 (Step-By-Step) 為主，閱聽人不需要知道太多 為什麼。照著做完會跑就是了。 2. 概念講述為主，閱聽人可能已經做過但又還沒有很明白地 知道他每一個步驟的意義。 3. 綜合以上二種型態的文件。第三種型態比較難寫，這幾乎 就是在寫書了。網路分享時，個人比較少寫這種型態的文 件，因為 mini-howto 和概念分享比較容易被讀完、讀懂 ，當然只是我個人的想法罷了。 不管那一種型態，認識名詞是必要的。排除不適合的讀者也是 必要的。 Compass 是建構在 Lucene 的 Framework 那麼，應 該建議不懂 Lucene 的人先學會了再來閱讀。並且 Compass是 配合 Object-Relational Mapping技術運作的，所以讀者也需 要知曉其中一種 ORM Framework，例如：Hibernate。 所以，回過頭來看您提供的分享，若真的要對讀者有所幫助。 那麼應該先告知使用者需要有的技能 [Lucene、Hibernate(或 其他 ORM Framework)]。然後指出，Compass 用了那些新概念 和 Facade 涵蓋過去在 Lucene 的功能。並且提供一個簡短的 步驟說明怎麼將 Compass 整合進 ORM 的使用流程之中。 最後，附上一些你查資料的地點，和獲得概念的來源網路就是 篇相關優質的分享文件了。 -- 類型1: step by step http://chingyichan.tw.googlepages.com/svn.install.html 類型2: 概念 http://www.javaworld.com.tw/jute/post/view?bid=43&id=150211&sty=3 類型1+2: 講稿型式(概念>實作) http://chingyichan.tw.googlepages.com/jQueryNotes.pdf 類型3: [不能說的秘密] --

※ 發信站: 批踢踢實業坊(ptt.cc) ◆ From: 140.112.13.88 ※ 編輯: qrtt1 來自: 140.112.13.88 (07/08 13:20) ※ 編輯: qrtt1 來自: 140.112.13.88 (07/08 13:24)