如何寫出好API文件

寫程式庫會需要寫 API 告訴使用者如何使用。
之前看過的  API 文件有些缺點。

• Doxygen：常常太簡陋。
• 仔細思考，問題出在寫的內容太少。
• 全部整理成為一個文件：覺得超長看不下去。
• 廠商的 reference manual 多半這樣寫。
• 仔細思考，因為用文件的唸法照順序念，當然太長。
• MSDN：很適合
• 內容很多，但是分頁下去後，可以只看想看的部分就好。

Euro Truck Simulator 2 技巧 Part 5 (for 鍵盤滑鼠)

沒想到會有 part 5。

又發現能讓方向盤更好操控的方法。

1. 眼睛看遠方，擴大視野。會變得自然能感覺整個環境、車道、和自己的車在車道的偏左還是偏右，還能知道怎樣才能最適當的轉彎。
2. 滑鼠靈敏度調低
3. 滑鼠拿歪的。

感覺可以先轉大一點，快到內側邊線再拉回

在 C 語言怎樣做物件導向

之前有機會看一個 open source 的 C 程式碼，看完了才發現居然是 C 語言。還以為是用 C++ 寫的。

https://github.com/gpac/gpac/blob/master/src/compositor/mpeg4_audio.c

行列輸入法的簡碼

接續上一篇：https://shainjung.blogspot.com/2019/05/blog-post_15.html

使用行列輸入法的時候覺得候選字的順序怪怪的，不是常用字在前，而且中間會有空的。

看到這一篇才了解原因，原來是按照下一碼排的位置。

學習行列輸入法

之前一直用新注音，但最近下定決心要練行列了。

Euro Truck Simulator 2 技巧 Part 4 (for 鍵盤滑鼠)

接續上一篇，
新增了怎樣才能轉彎轉的好

Euro Truck Simulator 2 技巧 Part 3 (for 鍵盤滑鼠)

1. 倒車時準確停入停車格的方法

   卡車倒車時常常會不小心倒成上面這樣，好不容易和車格平行了，結果沒進去。
   這邊紀錄要怎樣將車子往旁邊移動。

買了Google手機殼

之前用了別的手機殼，但是有些問題，決定還是用回 Google 的手機殼了。
問題是：

1. 偶爾會無線充電失敗，放了一晚上沒有充電。
2. 用皮套遮起來後，看起來都一樣，沒有人知道是Google手機。

所以還是買了 Google 的手機殼。

如何解決 Refactoring 改很大很難下手的問題

程式寫久了都會亂，需要重整。但是整理程式碼是吃力不討好的工作：

• 做的好，程式看起來完全沒有差異。
• 改錯了，原本穩定的程式立刻收到 bug reports。

雖然吃力不討好，但是要長久維護一個程式，整理程式碼是必須的動作。不然專案會越維護越痛苦，直到最後改不動，只能砍掉重寫。

以下是要幫大型專案重整的技巧。