X-Git-Url: https://git.r.bdr.sh/rbdr/r.bdr.sh/blobdiff_plain/43a46e6a9544dcd6bdb3240997a09ea1ca6cefbf..0da1e61b37923c15361d39ec230cc6f7d2f7658c:/jekyll/_posts/2015-09-05-api-notation.md diff --git a/jekyll/_posts/2015-09-05-api-notation.md b/jekyll/_posts/2015-09-05-api-notation.md index 52e2fc8..8e62abc 100644 --- a/jekyll/_posts/2015-09-05-api-notation.md +++ b/jekyll/_posts/2015-09-05-api-notation.md @@ -5,10 +5,10 @@ tags: english specs color: purple header_image: api-notation.gif description: "API notation is a simple way to document the public -contract of your componentsA" +contract of your components" --- -When writing specifications and trying to figure out how components will interact, an important part is to define the public API as the contract others can depend on: So if you have a complex feature where several people are collaborating, you can ease up the integration woes by properly defining the contract they'll be using to communicate. This means that I usually end up having to write APIs in text files constantly, and over the years I've come up with a notation for this. +When writing specifications and trying to figure out how components will interact, an important part of my workflow is to define the public API as the contract others can depend on: So if we have a complex feature where several people are collaborating, we can ease up the integration woes by properly defining the methods, properties and events they'll be using to communicate. This means that I usually end up having to write APIs in spec files constantly, and over the years I've been using and developing a notation for this. The API notation is very simple and encodes what public properties, methods and events an object/class provides. It looks like this: @@ -44,4 +44,4 @@ If you do decide to give it a try, let me know how it works out for you and if t [vim]: https://github.com/rbdr/api-notation.vim [atom]: https://github.com/rbdr/api-notation-atom -[sublime]: https://github.com/rbdr/api-notation.tmLanguage \ No newline at end of file +[sublime]: https://github.com/rbdr/api-notation.tmLanguage