資料夾結構

[caasi]

如何組織個章節的心得、參考資料比較合適？

線下線上會後，都用 markdown 整理？都用 issue ？還是靠 repo 提供的 wiki ？

我偏向整理回 repo 本身，這樣可以 clone 起來看。

[caasi]

@lancetw 提到：

12:24 <lancetw> 現在不是有 gitbook XD?
12:25 <lancetw> 三個願望一次滿足

[drm343]

gitbook 之前有用過，感覺 render 有點慢
我個人是贊成整理回 repo 的方式，如果有需要轉格式，也可以自己轉或丟給有提供這項服務的網站處理

issue 我個人還是偏好放暫時性的議題，心得之類的放 issue 可能之後會蠻不好找的

看有沒有人能分享一下使用 wiki 的優點吧

[caasi]

補充更多 log ，已移除無關的部分：

13:32 <lancetw> caasih: 現在 gitbook 應該可以結合 repo 吧（？
13:32 <lancetw> caasih: 我看大家都是在 repo 裡有文件 markdown files
13:33 <lancetw> 然後看可以用 gitbook 看
13:34 <lancetw> repo 裡有個 docs 資料夾這樣
13:37 <caasih> yulin lancetw: 我設想的是，結果應該是每個人的心得之類的，
13:38 <caasih> 跟原書比起來像是註啊疏啊什麼的。
13:39 <caasih> 這樣像 gitbook 分章節那樣好嗎？還是說一個個彼此有連結的 markdown 就好了？
13:39 <cataska> 把文件寫在 github wiki 的好處是有線上編輯器可用
13:39 <lancetw> caasih: gitbook 很適合吧？
13:39 <caasih> cataska: 缺點是不能 clone 下來讀？
13:39 <cataska> caasih: 對
13:39 <caasih> lancetw: 除了按章節外，還可以分主題這樣？
13:40 <caasih> 聽來不錯。
13:40 <lancetw> caasih: 可以一個人一章 XDDD
13:40 <lancetw> 應該不會蓋到 XD
13:40 <caasih> 有人有三章（誤
13:40 <cataska> wIki 看不到歷史紀錄的樣子
13:40 <lancetw> 引言就跟一般放程式碼一樣...
13:41 <caasih> cataska: 除了線上編輯外， wiki 好像越討論越雞肋 :/
13:41 <lancetw> wiki 其實是要最後整理用的
13:42 <lancetw> 而不是多人共用 XD
13:42 <lancetw> caasih: 線上有 hackpad
13:42 <cataska> caasih: 對啊
13:42 — caasih 不知道， c2 也是個共筆 wiki ，只是很難讀
13:43 <cataska> 等 Dropbox Paper...
13:43 <lancetw> caasih: 如果要暫存或是整理可以用 hackpad ...
13:43 <lancetw> cataska: 出很久啦
13:44 <caasih> lancetw: hackpad 好，適合活動時線上線下協作，但最後總要有倒楣鬼整理回 repo XD
13:44 <cataska> lancetw: 目前還是邀請制不是嗎
13:44 <lancetw> cataska: 不然可以自己架 hacked ...
13:44 <lancetw> cataska: hackpad
13:44 <lancetw> caasih: 如果要多人各自筆記其實 gitbook 形式比較好 XD

[caasi]

更多有關 gitbook 的討論：

07:39 <lancetw> caasih: 現在的 StudyGroup-TAPL repo 感覺對 gitBook 有什麼誤會 XD
07:58 <caasih> lancetw: 對啊，不知道是誰弄的 XD
08:16 <lancetw> caasih: 可以的話 repo 第一層就長成 docs/  src/ README.mdz 這種形狀就好
08:17 <lancetw> gitbook 只是輔助
08:17 <caasih> lancetw: 接了 gitbook 後他是會幫我 build ，但不會丟到 gh-pages ...
08:18 <lancetw> caasih: 我不太懂為什麼 master 是這種形狀 XD
08:19 <lancetw> 都是 md 就好了吧 XD
08:19 <lancetw> 總之 gitbook 是 optional，現在感覺變成主體 XDD
08:20 <caasih> 分 section 是想說 code 可以也分章節放
08:20 <caasih> dist 還有 build.sh 是因為不想用 gulp-gh-pages
08:21 <lancetw> section 那個應該是沒問題吧
08:21 <lancetw> 只是目前變成為了 gitbook 而 gitbook 的感覺 XD
08:26 <caasih> 0rz
08:27 <lancetw> caasih: 陷入玩工具的迷思 XD
08:31 <whitglint> lancetw: 這是個工具迷惑人心的時代
08:31 <whitglint> 每天都有新工具蹦出
08:35 <lancetw> whitglint: 沒 Word 就交不了報告!
08:35 <caasih> whitglint: 長輩早喵
08:37 <lancetw> caasih: 我覺得 repo 長這樣就可以了 https://github.com/rackt/redux/tree/master/docs
08:37 <lancetw> caasih: gitbook build 不是最優先事項 XD
08:38 <lancetw> 我個人是偏好 docs/ 底下只有 md
08:39 <lancetw> code 放到 src/
08:40 → yulin joined (7876c973@gateway/web/freenode/ip.120.118.201.115)
08:44 <caasih> yulin: 早安
08:44 <yulin> 早安
08:45 <caasih> lancetw: 清過了， https://github.com/cschat-tw/StudyGroup-TAPL
08:45 <whitglint> caasih: 早喵
08:45 <yulin> 喔喔，讚
08:45 <caasih> 資料夾該怎麼放，看讀書會的需要再調整吧
08:45 <yulin> whitglint: 早
08:46 <caasih> yulin: 按 lancetw 的建議，改用 gitbook webhook
08:46 <whitglint> yulin: 喵
08:46 <lancetw> caasih: 我覺得重點是在多人寫文件 XD
08:46 <caasih> 現在會自動發佈到 https://cschat-tw.gitbooks.io/studygroup-tapl/content/section1/index.html
08:46 <lancetw> caasih: gitbook 只是事後看

大意就是 gitbook 當輔助，主要還是以線下會的共筆為主，事後再整理到 repo 中。