但是沒有人寫JSON跟XML的時候,會覺得這是寫給人看,因為這樣的關係,雖然OAS裡面可以容納資料、圖例及互動流程的地方,大家不會一下子想到那邊去,結果是常常那個地方是空的,好比像API的要求,好比一個寫入好了,其實可以附範例資料的東西,甚至裡面要用超連結或內嵌圖片的方式放進去在說明欄,也沒有不可以,因為不是Markdown,大部分的人不會往這個方向想。