2 ms·
> Document it well, and it will largely be usable. And a simple, easy-to-use API will also be comparatively simple to document. If you're at the point where w
by ascagnel_ 11y ago
> Document it well, and it will largely be usable.
And a simple, easy-to-use API will also be comparatively simple to document. If you're at the point where writing documentation is hard, that's strong code smell that something is amiss.
- laveur 11y agoAgreed! The API should basically document itself. If you have to provide long examples of how to do something then there is a good chance the API isn't that good. Easy to use for developers makes a platform more stable and produces better quality apps, IMHO.