寫的什么？

現(xiàn)在開發(fā)都要用到接口文檔。不寫的話代碼不知道怎么維護(hù)，寫的話又費(fèi)時費(fèi)力，更煩人的是有時候?qū)懲炅饲岸诉€要來問這個參數(shù)那個參數(shù)，真的苦不堪言。
在前后端分離的近幾年，寫接口文檔對我來說是老大難，后面特地去查了自動化工具的理論，才茅塞頓開。至少對于寫文檔的思路清晰了許多！
那么現(xiàn)在就來分享一下我怎么做的吧！

要做什么？

我們的目標(biāo)，是寫出清晰簡練的文檔。所以，首先我們要確定：怎么才是清晰簡練的文檔。
如下圖所示：

上面的文檔簡練在哪？

首先，讓你知道它的功能，參數(shù)，一目了然；
其次，你輸入?yún)?shù)就能馬上看到結(jié)果。

我希望的是在完成代碼后，可以費(fèi)很少的力氣，就生成一個像上圖所示的可調(diào)試文檔。
那么接下來要做兩件事：
1、自動生成可視化的文檔；
2、文檔可調(diào)試。

怎么協(xié)作？

一是可以直接在工具里完成整個項目，二是導(dǎo)出不同格式的項目文檔，可用于其他文檔工具。

結(jié)語

我實(shí)現(xiàn)的工具是Eolinker
使用地址是：www.eolinker.com
類似的工具有很多， swagger editor，gwsee，apidoc，都還可以。
寫這篇文章不是推薦什么工具，但是自己走過一遍，肯定會有收獲哈哈:)