October 31 - November 2  - Portland, OR
Click Here For Information & Registration
Back To Schedule
Thursday, November 2 • 3:00pm - 3:20pm
Don't Repeat Yourself - Your API is Your Documentation - Michael Hibay, Baysong Services

Log in to save this to your schedule, view media, leave feedback and see who's attending!

"If you find yourself maintaining a set of documents explaining the use of your API, you haven't finished it's design yet. This talk will compare various strategies with examples, while discussing ways to determine the most appropriate method for your API.

We will explore OAS (Swagger), Json-LD, Schema.org, HAL, Hydra, Siren, Semantic profiles, and other formats while comparing their relative strengths and weaknesses. After these options, we will arm you with a series of questions which direct you to the appropriate tool for your API.

Discover how you can save considerable time and headaches by incorporating a self documenting method in your API design."

avatar for Michael Hibay

Michael Hibay

hAPI evangelist, Architect, and Java Developer, Baysong Services
Michael Hibay is a hAPI Evangelist, architect, java developer, katharsis.io maintainer, bad guitarist, and terrible singer who is writing the hAPI specification. He has designed and contributed to APIs in Fintech, E-Commerce, tax services, and sports management industries. When not... Read More →

Thursday November 2, 2017 3:00pm - 3:20pm PDT
Pavilion West