Sort:  

Yes it is, but that is only useful when someone is actually using your API, here its all about documenting whole architecture