"Api-Design"
- SDK 公開 API 設計 init / event / error / metric / flush / close 六個方法構成 SDK 的完整生命週期 — 跨平台共用相同 API 介面
- 函式文件分層設計:型別、介面、實作各自該寫什麼 函式文件分層設計:把資訊放在能表達它的最低層次(名稱 / 型別簽章 / 介面 doc / 實作 doc / 範例與測試)、上層留給「下層表達不了的剩餘」。整理各層該寫什麼、容易誤入的內容、配合反模式列表跟寫 doc 前 checklist 收斂出短而精準的文件。
- 型別取代 doc 的收益曲線:強型別語言的 doc 該有多短 型別系統強化等於 doc 表達力轉移——很多 doc 內容應該下移到型別。整理 null safety / enum / wrapper / Result / typestate 各能消除哪類 doc、型別表達不了的剩餘部分(業務動機、性能、副作用、時序)以及收益曲線的邊際遞減點。