在以前的項目裏為了寫作方便,總是以word文檔的方式提供架構和設計文檔,帶來的好處僅僅是自己寫作起來較為方便,但帶來的麻煩卻有很多,比如:

  • 更新文檔較為麻煩。
  • 他人瀏覽較為麻煩,特別當需要從docx轉換到doc的時候。
  • 很難形成與其他文檔的聯繫。
  • 難以協同合作

以上的缺點導致很不好的後果:設計有了更新卻懶於同步到文檔裏,他人也不願看文檔,乾脆直接來問設計者,文檔支凌破碎,寫文檔成了個別人的事情。因此在計費二期裏我決定擯棄用word的形式,改成用wiki,並在公司wiki裏好好規劃起來,相比較word,wiki有以下好處:

  • 完成基本格式文檔很方便。
  • 文檔聚合和組織很方便,關鍵在於要善於用標記語言,可以參考:http://www.adaptavist.com/display/AtlassianConfluence/Macros
  • 隨時隨地可以寫文檔和更新
  • 隨時隨地可以查看文檔
  • 協同合作較為方便

幾個優點馬上帶來了改觀:

  • 文檔時效性明顯提高
  • 開發人員開始樂意寫文檔,寫文檔成了全民運動
  • PD和測試人員樂意看文檔,不再常常騷擾開發人員
  • 文檔組織井井有條,展現了項目開發的專業性
  • 設計評審時一目瞭然,使得會議進行得順利流暢
  • 讓項目過程有效記錄下來,使合作更加清晰明瞭

從這個小事情上發現一個道理,幹項目不僅需要執行力,還需要小技巧和不斷改進,往往一些小小的改進,帶來的好處會讓你意想不到