別用 RAML 撰寫你的 API 文件,千萬不要。

這篇文章專門講解我如何被 RAML 騙到入坑然後放棄的過程。最近在找 API 文件工具,然後就剛好看見了 RAML,RAML 是一個撰寫 API 文件的格式,風格是延續 YAML 的。 現在讓我們看看官方網站的示意圖,你會發現:「哇,這根本夭壽棒啊!」。 所以我才被騙進來了,不是嗎?如果你現在打算用 RAML,請留步。 撰寫風格一般