沒把工商服務講完 閃電秀挑戰失敗 XD Anyway,歡迎加入 Tainan.py： http://www.meetup.com/Tainan-py-Python-Tainan-User-Group/

1. API 文件大亂鬥
Joe @ MOPCON 2013

2. 分享
各式各樣撰寫文件的方法

3. 什麼時候 可能不用撰寫文件
1. 不寫 API
2. 自己全包前後端
Parse, Firebase, deployd ...

4. Parse -> 好用
罩門
複雜資料
受限代管
需要淺淺
喬巴式馬賽克
小結論：有規模可考慮自己架 Server ...

5. 回到正題
各種撰寫文件的方法

6. 解一
直接講
變種：Line, FB, Hipchat ...

7. 情境
誒，oxoxox API
怎麼用啊 ？
前天不是講過了 ...

8. 評估
很糟糕
BJ4
喬巴式馬賽克

9. 解二
直接寫
演化：txt, doc, google doc ...

10. 情境
請參閱
閱
三天後
怎麼不能用？
拍謝，修過程式！文件未更新

11. 評估
適用小專案
需要維護
越詳細越需人力

12. 解三
用工具寫
站在巨人的肩膀上

18. 情境
寫好沒？
先學寫文件先，等
三天後
寫好沒？
正要開始寫

19. 評估
的確還不錯
學習成本不一
（有些）仍然有同步問題

20. 要站在巨人的肩膀上其實不容易 ...

21. 接下來提供不寫文件的方式寫文件
怎麼可能

22. 解四
請同事自己看 Code
會被揍飛

23. 解五
用框架自動生成
例如：Django Rest Framework

25. 情境
讚！
如果我會該框架的話

26. 評估
程式與文件合一
請參閱各語言框架

27. 解六
自幹自動生成
Non-Django Framework

28. +

29. 使用 Form Validation 定義 Input 格式

30. 寫個 Decorator 截取文件所需的資訊
Done ?

31. 沒有測過的文件不能相信
通過測試就存起來

32. 再來就是輸出網頁

35. 評估
也還不錯
需建構成本
開發環境 Only

36. 總結
自取所需
歡迎分享其他方法

37. 工商服務

39. X

40. 更多 Python

41. Tainan.py 聚會時間
• 每個月最末周周六 14:00 舉辦
• 下一次暫定：11/30
(六) 14:00

42. QA
請勿詢問本月 10/26 為什麼沒舉辦聚會