詳解功能版本管理之使用eoLinker
阿新 • • 發佈:2017-11-28
object 可見 nts 平臺 sso fonts 一覽 多次 動態 現在公司終於拋棄了傳統的文檔編寫接口文檔的方式,采用在線接口管理平臺eoLinker錄入接口信息。eoLinker對api接口提供版本管理功能,清晰記錄了接口修改的動態,還可以進行一鍵化接口回滾。
先看一個對話:
“這裏,你改一下,這裏返回一個object。”
“好...好......”
“還有這裏,返回個String。”
......
在接口文檔改了7、8個version後,組長又發話了,“我覺得還是先前第2個版本的參數描述和說明更直觀一點,你改回來吧。”
......
“額......第二個版本的參數是怎麽寫來著......”
嗯,我一個180的大漢,這一刻想一拳打死組長。
已經不止一次遇到這樣的情況了,代碼不斷更新叠代,接口文檔同時根據代碼變動和進行細節上的改動,在改動多次後又倒退回原來的版本。雖說實踐出真知,但如果先前的文檔可以保存,根據討論來進行接口文檔版本切換...那就更好了...
例如可以通過設置接口狀態來區分接口,接口狀態分為啟用、維護和棄用
接口列表一覽
修改後點擊保存,填入更新描述,記錄接口修改描述。
選擇“歷史”,獲取最近十條接口修改歷史,接口歷史清晰可見。
選擇需要切換的接口歷史,便可一鍵切換
切換前
切換後
自從使用eoLinker進行接口版本管理,機械重復的工作就沒必要再做了,要切換回之前的接口版本,只需要點擊切換即可。
現在我已經沒有那種手刃組長的想法了,嗯,eoLinker讓組長多活幾年。
本文轉載於Blog.CSDN,已獲作者允許轉載。
詳解功能版本管理之使用eoLinker