- Clarify how to launch postman examples and consider to add curl (or other way) of testing the APIs. Because of this:
- using variable failxs. Postman allows you to set 2 values for a variable - initial and current. I had the initial set only but it turns out it uses the current one
- To open an installed Postman from link "Run in Postman" on Ubuntu 14.04, I had to add to add postman protocol to mimeapps.list
And then create a postman.desktop...
- Simplify documentation to not use HAL or any other Hypermedia format upfront, that way maybe the developer consign the API is scared of learning anything related with Hypermedia formats. Instead, use plain JSON for the first API examples.