If you’ve been spending much time on the Nordic APIs blog, you’ll know that developer experience is something we’re passionate about. Creating a smooth and enjoyable experience for those implementing your APIs is essential with just how much competition there is nowadays, and API documentation is one of the keys to success. Read more
Posts Tagged: GitHub
With all of the love and proclamations about REST, we can sometimes forget that it’s simply one of many options. REST is a very good standard for a wide variety of APIs, but there are other API design styles for more nuanced scenarios. Read more
Clojure is a powerful language, but as with any language, its true power comes through extensibility. The ability to plug in additional modules and open up functionality is key to the proper development of a Clojure application, and as such, understanding both how Clojure functions and how the various frameworks interlock is key to proper development. Read more
On the one hand, having proper API documentation can be a sign of early success for an API provider, allowing new users to effectively understand the functionalities and caveats behind an API solution.
On the other hand, extensive documentation could indicate an overly complex solution with far too many variables to navigate. Read more