4 ms·
The article describes some very good engineering practices. Nevertheless I’d suggest the json Schema itself is not the root of the documentation but a higher le
by theK 8y ago
The article describes some very good engineering practices. Nevertheless I’d suggest the json Schema itself is not the root of the documentation but a higher level integrated system like API Blueprints MSON. You still can produce Schema from it but it also can tie into a much better API design lifecycle.
- handrews 8y agoYes, JSON Schema describes documents/resources, not entire APIs on its own. Even Hyper-Schema (to the extent that it's implemented at all yet) is a resource-by-resource system, not an API-scope system.