Re:UK Government Guidelines on Documenting APIs
by jollygoodshow on Sunday May 22, 2022 @10:44AM
(#31468729)
I don't think they expect you create an exhaustive list of things the API doesn't do. I think instead that if there's missing functionality from what you could call a 'complete' API, it's useful to call that out. E.g this API is for processing images, but we don't support PNG
This could mean specifying a LOT of things that an API cannot do, but it's easier to state what an API can't do rather than list all its capabilities, similar to how people can list 100s of negative emotions and fail bad at specifying lots of positive emotions.