Lastor
[工作雜][牢騷] 聽到其他部門的在說寫了文件都不看...etc，有點無奈。因為你們那文件實質上並沒有辦法幫助我們了解這 API 到底要怎麼接
Lastor
我之前就碰到這問題，現在 leader 去接他也一樣看不懂
Lastor
那這到底是我們不看文件，還是那文件根本沒幫助? 我就笑笑 
Lastor
有一些串接案例，例如說 API A 他上面 doc 就大概寫說這參數 a 是啥，參數 b 是啥
Lastor
實際跑不會動，再去問才知道說，原來要先 call API B 才能 call API A
Lastor
不然就是參數說明寫了一個專有名詞就沒了，鬼知道這是啥
Lastor
反正現在要跟他們接 API 的活我就盡量躲，讓別人去煩，不想折壽。其他人都領受過之後，就會知道我為啥說那文件有寫跟沒寫一樣 
Lastor
而且之前也稍微抱怨過，他們寫這文件的最大目的，整個透露出來的並不是希望藉由文件幫助溝通，而是希望寫這文件來達成「不要溝通」
Lastor
這樣最後怎麼可能會有好結果，不僅沒有解決我們 API 覺得難接的問題，反而還給自己加了工作量
Lastor
那現在只有我們在接這些 API，看看等以後真的單賣 APIs 給別人用的時候，別人也說難接、看不懂、接不起來，到時候我再來展現一下禮貌又不失尷尬的微笑 
Lastor
嘛，現在這份工作，前端的部分因為最初 build 專案架構的人有用很多新技術，所以前端這塊是好玩的
Lastor
但是跟韌體 API 對接那邊真的是無比痛苦，遠比跟難溝通的 Web 後端對接要痛苦好幾倍
Lastor
不對，應該不遑多讓才對