Re:
by tkiolp4 on Monday March 25, 2024 @05:51PM
(#39821647)
What’s wrong with designing an API by writing its code? Code itself is a design tool (and usually any decent programming language is a better design tool than YAML)
[ Parent
| on HN ]
Re:
by spondylosaurus on Monday March 25, 2024 @06:46PM
(#39822094)
As someone who documents APIs: it's easy to tell which APIs were designed with intention and which ones were designed on the fly. In part because it's much, much easier to document the former :)