SlideShare a Scribd company logo
©  Avalara
Translating  and  Testing  your  documentation
From  API  Description  
to  Developer  Site
Anya  Stettler
Defrag  2015
Making  sales  tax  less  taxing 2CONFIDENTIAL   &  PROPRIETARY       |
Making  sales  tax  less  taxing 3CONFIDENTIAL   &  PROPRIETARY       |
Making  sales  tax  less  taxing 4CONFIDENTIAL   &  PROPRIETARY       |
https://stripe.com/docs/api#charges
Making  sales  tax  less  taxing 5CONFIDENTIAL   &  PROPRIETARY       |
Policy  AND  Technology
Making  sales  tax  less  taxing 6CONFIDENTIAL   &  PROPRIETARY       |
Making  sales  tax  less  taxing 7CONFIDENTIAL   &  PROPRIETARY       |
…/v2/users
Vs
…/2.0/users
Consistency  is  key
Making  sales  tax  less  taxing 8CONFIDENTIAL   &  PROPRIETARY       |
Not  everything  is  worth  fighting  about
Making  sales  tax  less  taxing 9CONFIDENTIAL   &  PROPRIETARY       |
Central  dictionary  for  
shared  vocabulary
We  all  need  to  speak  the  
same  langauge
Making  sales  tax  less  taxing 10CONFIDENTIAL   &  PROPRIETARY       |
Rules  can’t  stand  alone
Making  sales  tax  less  taxing 11CONFIDENTIAL   &  PROPRIETARY       |
More  tools,  less  governance!
Making  sales  tax  less  taxing 12CONFIDENTIAL   &  PROPRIETARY       |
The  right  way  should  be  easy
Making  sales  tax  less  taxing 13CONFIDENTIAL   &  PROPRIETARY       |
draft  standards
draft  standards
...  in  committee
create  tools
management
management
management
Nag  nag  nag...
tool  
maintenance
time  saved  
through  
automation
Making  sales  tax  less  taxing 14CONFIDENTIAL   &  PROPRIETARY       |
https://github.com/paypal/api-­standards/blob/master/api-­style-­guide.md
Making  sales  tax  less  taxing 15CONFIDENTIAL   &  PROPRIETARY       |
Franchise!
-­‐ Value  input
-­‐ Pilot  program
-­‐ Transparent  
feedback
Making  sales  tax  less  taxing 16CONFIDENTIAL   &  PROPRIETARY       |
Guide  lines  road
Making  sales  tax  less  taxing 17CONFIDENTIAL   &  PROPRIETARY       |
Making  sales  tax  less  taxing 18CONFIDENTIAL   &  PROPRIETARY       |
http://swagger.io/
Making  sales  tax  less  taxing 19CONFIDENTIAL   &  PROPRIETARY       |
?
Making  sales  tax  less  taxing 20CONFIDENTIAL   &  PROPRIETARY       |
Is  it  valid  Swagger?
Making  sales  tax  less  taxing 21CONFIDENTIAL   &  PROPRIETARY       |
Vendor headers
Making  sales  tax  less  taxing 22CONFIDENTIAL   &  PROPRIETARY       |
A  single  “source  of  truth”  definition
Makes  it  easy  for  technical  writers
Making  sales  tax  less  taxing 23CONFIDENTIAL   &  PROPRIETARY       |
Swagger  accurately  reflects  API?
Making  sales  tax  less  taxing 24CONFIDENTIAL   &  PROPRIETARY       |
Follows  company  style  guide?
Making  sales  tax  less  taxing 25CONFIDENTIAL   &  PROPRIETARY       |
Making  sales  tax  less  taxing 26CONFIDENTIAL   &  PROPRIETARY       |
We  still  need  people!
• Human-­‐readable  
property  
definitions
• Define  business  
flows
• Describe  best  
practices
Making  sales  tax  less  taxing 27CONFIDENTIAL   &  PROPRIETARY       |
Making  sales  tax  less  taxing 28CONFIDENTIAL   &  PROPRIETARY       |
Making  sales  tax  less  taxing 29CONFIDENTIAL   &  PROPRIETARY       |
2.  https://upload.wikimedia.org/wikipedia/commons/a/af/Bedarra_Island_aerial.jpg
3.  https://upload.wikimedia.org/wikipedia/commons/7/7e/Palau_archipelago.jpg
5.  https://pixabay.com/p-­35105/
7.  https://www.flickr.com/photos/nelsonminar/286841113
8.  https://upload.wikimedia.org/wikipedia/commons/e/eb/Bicycle_shed.JPG
10.  https://commons.wikimedia.org/wiki/File:United_States_Code_Law_Book_Boston_Public_Library_6D2B1951.jpg
11.  https://www.flickr.com/photos/dominicotine/7696681446
12.  https://c1.staticflickr.com/3/2451/3704243811_55b45a0fd0_b.jpg
15.  https://commons.wikimedia.org/wiki/File:Dog_dressed_in_an_airplane_outfit.jpg
http://ichef-­1.bbci.co.uk/news/640/media/images/67206000/jpg/_67206577_de25.jpg
16.  http://s3.freefoto.com/images/21/11/21_11_7_web.jpg
19.  https://c2.staticflickr.com/4/3220/2936038678_06ae77a09d.jpg
https://www.flickr.com/photos/dapuglet/8479185386
https://c1.staticflickr.com/3/2792/4195466130_cdccf7f7c3_b.jpg
https://c1.staticflickr.com/3/2819/9190710208_cd972cd9c1.jpg
https://c1.staticflickr.com/1/2/1616041_2f42627c7b.jpg
https://pixabay.com/p-­309065/
20.  https://www.flickr.com/photos/mbtrama/325408685
https://www.flickr.com/photos/8113246@N02/8203258965
23.  https://www.flickr.com/photos/jurvetson/6877434491
25.  https://upload.wikimedia.org/wikipedia/commons/thumb/0/0b/Sandro_Botticelli_-­_La_nascita_di_Venere_-­
_Google_Art_Project_-­_edited.jpg/1280px-­Sandro_Botticelli_-­_La_nascita_di_Venere_-­_Google_Art_Project_-­_edited.jpg
26.  https://upload.wikimedia.org/wikipedia/commons/thumb/e/e7/Quill_(PSF)_vector.svg/2000px-­
Quill_(PSF)_vector.svg.png
27.  https://www.flickr.com/photos/portland_mike/969236814
Image  Credits
Making  sales  tax  less  taxing 30CONFIDENTIAL   &  PROPRIETARY       |
Thanks!
Anya  Stettler
Product  Manager,  API
Avalara
anyarms
anya.stettler@avalara.com

More Related Content

What's hot

Managing private, partner & public APIs (Nordic APIS April 2014)
Managing private, partner & public APIs (Nordic APIS April 2014)Managing private, partner & public APIs (Nordic APIS April 2014)
Managing private, partner & public APIs (Nordic APIS April 2014)
Nordic APIs
 
Spark Presentation
Spark PresentationSpark Presentation
Spark Presentation
sparkexpo
 

What's hot (15)

Must-Have Property Management Tools To Boost Your Efficiency
Must-Have Property Management Tools To Boost Your EfficiencyMust-Have Property Management Tools To Boost Your Efficiency
Must-Have Property Management Tools To Boost Your Efficiency
 
How Property Managers Can Pivot to Compete in an On-Demand Economy
How Property Managers Can Pivot to Compete in an On-Demand EconomyHow Property Managers Can Pivot to Compete in an On-Demand Economy
How Property Managers Can Pivot to Compete in an On-Demand Economy
 
Attract & Retain Top Talent in Today’s Tech-Driven World
Attract & Retain Top Talent in Today’s Tech-Driven WorldAttract & Retain Top Talent in Today’s Tech-Driven World
Attract & Retain Top Talent in Today’s Tech-Driven World
 
Spark tg ppt-2018
Spark tg ppt-2018Spark tg ppt-2018
Spark tg ppt-2018
 
APIdays Zurich 2019 - Reactive & Distributed - Modern application architectur...
APIdays Zurich 2019 - Reactive & Distributed - Modern application architectur...APIdays Zurich 2019 - Reactive & Distributed - Modern application architectur...
APIdays Zurich 2019 - Reactive & Distributed - Modern application architectur...
 
Managing private, partner & public APIs (Nordic APIS April 2014)
Managing private, partner & public APIs (Nordic APIS April 2014)Managing private, partner & public APIs (Nordic APIS April 2014)
Managing private, partner & public APIs (Nordic APIS April 2014)
 
PINless-NEW
PINless-NEWPINless-NEW
PINless-NEW
 
They Want it Now: How Property Managers Can Deliver on High Service Expectations
They Want it Now: How Property Managers Can Deliver on High Service ExpectationsThey Want it Now: How Property Managers Can Deliver on High Service Expectations
They Want it Now: How Property Managers Can Deliver on High Service Expectations
 
#3 DataBeersBCN - "Big Fun Data" by Xavier Guardiola
#3 DataBeersBCN - "Big Fun Data" by Xavier Guardiola#3 DataBeersBCN - "Big Fun Data" by Xavier Guardiola
#3 DataBeersBCN - "Big Fun Data" by Xavier Guardiola
 
APIdays Zurich 2019 - APIs for real time communication Miguel Lopes, Dialogic
APIdays Zurich 2019 - APIs for real time communication Miguel Lopes, DialogicAPIdays Zurich 2019 - APIs for real time communication Miguel Lopes, Dialogic
APIdays Zurich 2019 - APIs for real time communication Miguel Lopes, Dialogic
 
Sales Cycle in Corporate vs Startup
Sales Cycle in Corporate vs StartupSales Cycle in Corporate vs Startup
Sales Cycle in Corporate vs Startup
 
Spark Presentation
Spark PresentationSpark Presentation
Spark Presentation
 
Watson Assistant by Sheila O'Hara & Christophe Borde @ Vivatech
Watson Assistant by Sheila O'Hara & Christophe  Borde @ VivatechWatson Assistant by Sheila O'Hara & Christophe  Borde @ Vivatech
Watson Assistant by Sheila O'Hara & Christophe Borde @ Vivatech
 
Tea Sales Management System v4
Tea Sales Management System v4Tea Sales Management System v4
Tea Sales Management System v4
 
GeneXus ERP connector para SAP ERP
GeneXus ERP connector para SAP ERPGeneXus ERP connector para SAP ERP
GeneXus ERP connector para SAP ERP
 

Viewers also liked

Google IO Sandbox Interview
Google IO Sandbox InterviewGoogle IO Sandbox Interview
Google IO Sandbox Interview
dalaigh
 

Viewers also liked (8)

APIs And SDKs Breaking Into And Succeeding In A Specialty Market
APIs And SDKs  Breaking Into And Succeeding In A Specialty MarketAPIs And SDKs  Breaking Into And Succeeding In A Specialty Market
APIs And SDKs Breaking Into And Succeeding In A Specialty Market
 
Insights on Mobile Futures from Columbia University's Gil Zussman
Insights on Mobile Futures from Columbia University's Gil ZussmanInsights on Mobile Futures from Columbia University's Gil Zussman
Insights on Mobile Futures from Columbia University's Gil Zussman
 
Google IO Sandbox Interview
Google IO Sandbox InterviewGoogle IO Sandbox Interview
Google IO Sandbox Interview
 
Extend sdk
Extend sdkExtend sdk
Extend sdk
 
Turbocharge your API strategy with SDK
Turbocharge your API strategy with SDKTurbocharge your API strategy with SDK
Turbocharge your API strategy with SDK
 
Wtf is API and SDK
Wtf is API and SDKWtf is API and SDK
Wtf is API and SDK
 
The Marketing Playbook for API & SDK Adoption
The Marketing Playbook for API & SDK AdoptionThe Marketing Playbook for API & SDK Adoption
The Marketing Playbook for API & SDK Adoption
 
Best Practice iPhone SDK App Design
Best Practice iPhone SDK App DesignBest Practice iPhone SDK App Design
Best Practice iPhone SDK App Design
 

Similar to API Description to Developer Portal: Translating and Testing your Documentation

How the heck does anyone make money from an API anyway
How the heck does anyone make money from an API anywayHow the heck does anyone make money from an API anyway
How the heck does anyone make money from an API anyway
Greg Kliewer
 

Similar to API Description to Developer Portal: Translating and Testing your Documentation (20)

How the heck does anyone make money from an API anyway
How the heck does anyone make money from an API anywayHow the heck does anyone make money from an API anyway
How the heck does anyone make money from an API anyway
 
The new B2B Buyer Experience Feb2019 Ansaco
The new B2B Buyer Experience Feb2019 AnsacoThe new B2B Buyer Experience Feb2019 Ansaco
The new B2B Buyer Experience Feb2019 Ansaco
 
Survive Industry Disruption and Deliver a Great Customer Experience with APIs...
Survive Industry Disruption and Deliver a Great Customer Experience with APIs...Survive Industry Disruption and Deliver a Great Customer Experience with APIs...
Survive Industry Disruption and Deliver a Great Customer Experience with APIs...
 
Creating an Omnichannel Experience for Your Customers
Creating an Omnichannel Experience for Your CustomersCreating an Omnichannel Experience for Your Customers
Creating an Omnichannel Experience for Your Customers
 
IRIS World 2018 - Keynote - Thrive in the Digital Economy
IRIS World 2018 - Keynote - Thrive in the Digital EconomyIRIS World 2018 - Keynote - Thrive in the Digital Economy
IRIS World 2018 - Keynote - Thrive in the Digital Economy
 
How Artificial Intelligence is Applied to Drive Trade Effectiveness
How Artificial Intelligence is Applied to Drive Trade EffectivenessHow Artificial Intelligence is Applied to Drive Trade Effectiveness
How Artificial Intelligence is Applied to Drive Trade Effectiveness
 
API’s and Identity: Enabling Optum to become the HealthCare cloud
API’s and Identity: Enabling Optum to become the HealthCare cloudAPI’s and Identity: Enabling Optum to become the HealthCare cloud
API’s and Identity: Enabling Optum to become the HealthCare cloud
 
Twilio
TwilioTwilio
Twilio
 
Strangle Your Monolith, Not Each Other
Strangle Your Monolith, Not Each OtherStrangle Your Monolith, Not Each Other
Strangle Your Monolith, Not Each Other
 
Unlock The Power Of Real-Time Performance Data With Business iQ - AppD Global...
Unlock The Power Of Real-Time Performance Data With Business iQ - AppD Global...Unlock The Power Of Real-Time Performance Data With Business iQ - AppD Global...
Unlock The Power Of Real-Time Performance Data With Business iQ - AppD Global...
 
Leverage your Digital Insights to Drive Exceptional Customer Experiences - Sh...
Leverage your Digital Insights to Drive Exceptional Customer Experiences - Sh...Leverage your Digital Insights to Drive Exceptional Customer Experiences - Sh...
Leverage your Digital Insights to Drive Exceptional Customer Experiences - Sh...
 
Technology Primer: How to Achieve a Customer-Centric View in an Omni-Channel ...
Technology Primer: How to Achieve a Customer-Centric View in an Omni-Channel ...Technology Primer: How to Achieve a Customer-Centric View in an Omni-Channel ...
Technology Primer: How to Achieve a Customer-Centric View in an Omni-Channel ...
 
The steps of enterprise innovation at ACA IT-Solutions
The steps of enterprise innovation at ACA IT-SolutionsThe steps of enterprise innovation at ACA IT-Solutions
The steps of enterprise innovation at ACA IT-Solutions
 
Case Study: Versent Helps Companies Get Started in the Application Economy Wi...
Case Study: Versent Helps Companies Get Started in the Application Economy Wi...Case Study: Versent Helps Companies Get Started in the Application Economy Wi...
Case Study: Versent Helps Companies Get Started in the Application Economy Wi...
 
What makes a cellular IoT API great? Tobias Goebel
What makes a cellular IoT API great? Tobias GoebelWhat makes a cellular IoT API great? Tobias Goebel
What makes a cellular IoT API great? Tobias Goebel
 
2FA Best Practices
2FA Best Practices2FA Best Practices
2FA Best Practices
 
Scaling Your Software Sales: A Guide to the AppDirect Monetization Suite
Scaling Your Software Sales: A Guide to the AppDirect Monetization SuiteScaling Your Software Sales: A Guide to the AppDirect Monetization Suite
Scaling Your Software Sales: A Guide to the AppDirect Monetization Suite
 
Business Model Canvas mash-up with the 4Qs Framework. Mash-up by Allen Pattis...
Business Model Canvas mash-up with the 4Qs Framework. Mash-up by Allen Pattis...Business Model Canvas mash-up with the 4Qs Framework. Mash-up by Allen Pattis...
Business Model Canvas mash-up with the 4Qs Framework. Mash-up by Allen Pattis...
 
Your New Digital Business & APIs
Your New Digital Business & APIs Your New Digital Business & APIs
Your New Digital Business & APIs
 
How to Build Platforms, Not Products
How to Build Platforms, Not ProductsHow to Build Platforms, Not Products
How to Build Platforms, Not Products
 

Recently uploaded

How to Position Your Globus Data Portal for Success Ten Good Practices
How to Position Your Globus Data Portal for Success Ten Good PracticesHow to Position Your Globus Data Portal for Success Ten Good Practices
How to Position Your Globus Data Portal for Success Ten Good Practices
Globus
 

Recently uploaded (20)

Designing for Privacy in Amazon Web Services
Designing for Privacy in Amazon Web ServicesDesigning for Privacy in Amazon Web Services
Designing for Privacy in Amazon Web Services
 
Using IESVE for Room Loads Analysis - Australia & New Zealand
Using IESVE for Room Loads Analysis - Australia & New ZealandUsing IESVE for Room Loads Analysis - Australia & New Zealand
Using IESVE for Room Loads Analysis - Australia & New Zealand
 
Innovating Inference - Remote Triggering of Large Language Models on HPC Clus...
Innovating Inference - Remote Triggering of Large Language Models on HPC Clus...Innovating Inference - Remote Triggering of Large Language Models on HPC Clus...
Innovating Inference - Remote Triggering of Large Language Models on HPC Clus...
 
SOCRadar Research Team: Latest Activities of IntelBroker
SOCRadar Research Team: Latest Activities of IntelBrokerSOCRadar Research Team: Latest Activities of IntelBroker
SOCRadar Research Team: Latest Activities of IntelBroker
 
Understanding Globus Data Transfers with NetSage
Understanding Globus Data Transfers with NetSageUnderstanding Globus Data Transfers with NetSage
Understanding Globus Data Transfers with NetSage
 
AI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAG
AI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAGAI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAG
AI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAG
 
Globus Compute wth IRI Workflows - GlobusWorld 2024
Globus Compute wth IRI Workflows - GlobusWorld 2024Globus Compute wth IRI Workflows - GlobusWorld 2024
Globus Compute wth IRI Workflows - GlobusWorld 2024
 
How to Position Your Globus Data Portal for Success Ten Good Practices
How to Position Your Globus Data Portal for Success Ten Good PracticesHow to Position Your Globus Data Portal for Success Ten Good Practices
How to Position Your Globus Data Portal for Success Ten Good Practices
 
Beyond Event Sourcing - Embracing CRUD for Wix Platform - Java.IL
Beyond Event Sourcing - Embracing CRUD for Wix Platform - Java.ILBeyond Event Sourcing - Embracing CRUD for Wix Platform - Java.IL
Beyond Event Sourcing - Embracing CRUD for Wix Platform - Java.IL
 
Globus Compute Introduction - GlobusWorld 2024
Globus Compute Introduction - GlobusWorld 2024Globus Compute Introduction - GlobusWorld 2024
Globus Compute Introduction - GlobusWorld 2024
 
top nidhi software solution freedownload
top nidhi software solution freedownloadtop nidhi software solution freedownload
top nidhi software solution freedownload
 
Gamify Your Mind; The Secret Sauce to Delivering Success, Continuously Improv...
Gamify Your Mind; The Secret Sauce to Delivering Success, Continuously Improv...Gamify Your Mind; The Secret Sauce to Delivering Success, Continuously Improv...
Gamify Your Mind; The Secret Sauce to Delivering Success, Continuously Improv...
 
How Recreation Management Software Can Streamline Your Operations.pptx
How Recreation Management Software Can Streamline Your Operations.pptxHow Recreation Management Software Can Streamline Your Operations.pptx
How Recreation Management Software Can Streamline Your Operations.pptx
 
WSO2Con2024 - WSO2's IAM Vision: Identity-Led Digital Transformation
WSO2Con2024 - WSO2's IAM Vision: Identity-Led Digital TransformationWSO2Con2024 - WSO2's IAM Vision: Identity-Led Digital Transformation
WSO2Con2024 - WSO2's IAM Vision: Identity-Led Digital Transformation
 
OpenFOAM solver for Helmholtz equation, helmholtzFoam / helmholtzBubbleFoam
OpenFOAM solver for Helmholtz equation, helmholtzFoam / helmholtzBubbleFoamOpenFOAM solver for Helmholtz equation, helmholtzFoam / helmholtzBubbleFoam
OpenFOAM solver for Helmholtz equation, helmholtzFoam / helmholtzBubbleFoam
 
Large Language Models and the End of Programming
Large Language Models and the End of ProgrammingLarge Language Models and the End of Programming
Large Language Models and the End of Programming
 
Vitthal Shirke Microservices Resume Montevideo
Vitthal Shirke Microservices Resume MontevideoVitthal Shirke Microservices Resume Montevideo
Vitthal Shirke Microservices Resume Montevideo
 
Enhancing Research Orchestration Capabilities at ORNL.pdf
Enhancing Research Orchestration Capabilities at ORNL.pdfEnhancing Research Orchestration Capabilities at ORNL.pdf
Enhancing Research Orchestration Capabilities at ORNL.pdf
 
Breaking the Code : A Guide to WhatsApp Business API.pdf
Breaking the Code : A Guide to WhatsApp Business API.pdfBreaking the Code : A Guide to WhatsApp Business API.pdf
Breaking the Code : A Guide to WhatsApp Business API.pdf
 
Developing Distributed High-performance Computing Capabilities of an Open Sci...
Developing Distributed High-performance Computing Capabilities of an Open Sci...Developing Distributed High-performance Computing Capabilities of an Open Sci...
Developing Distributed High-performance Computing Capabilities of an Open Sci...
 

API Description to Developer Portal: Translating and Testing your Documentation

  • 1. ©  Avalara Translating  and  Testing  your  documentation From  API  Description   to  Developer  Site Anya  Stettler Defrag  2015
  • 2. Making  sales  tax  less  taxing 2CONFIDENTIAL   &  PROPRIETARY      |
  • 3. Making  sales  tax  less  taxing 3CONFIDENTIAL   &  PROPRIETARY      |
  • 4. Making  sales  tax  less  taxing 4CONFIDENTIAL   &  PROPRIETARY      | https://stripe.com/docs/api#charges
  • 5. Making  sales  tax  less  taxing 5CONFIDENTIAL   &  PROPRIETARY      | Policy  AND  Technology
  • 6. Making  sales  tax  less  taxing 6CONFIDENTIAL   &  PROPRIETARY      |
  • 7. Making  sales  tax  less  taxing 7CONFIDENTIAL   &  PROPRIETARY      | …/v2/users Vs …/2.0/users Consistency  is  key
  • 8. Making  sales  tax  less  taxing 8CONFIDENTIAL   &  PROPRIETARY      | Not  everything  is  worth  fighting  about
  • 9. Making  sales  tax  less  taxing 9CONFIDENTIAL   &  PROPRIETARY      | Central  dictionary  for   shared  vocabulary We  all  need  to  speak  the   same  langauge
  • 10. Making  sales  tax  less  taxing 10CONFIDENTIAL   &  PROPRIETARY      | Rules  can’t  stand  alone
  • 11. Making  sales  tax  less  taxing 11CONFIDENTIAL   &  PROPRIETARY      | More  tools,  less  governance!
  • 12. Making  sales  tax  less  taxing 12CONFIDENTIAL   &  PROPRIETARY      | The  right  way  should  be  easy
  • 13. Making  sales  tax  less  taxing 13CONFIDENTIAL   &  PROPRIETARY      | draft  standards draft  standards ...  in  committee create  tools management management management Nag  nag  nag... tool   maintenance time  saved   through   automation
  • 14. Making  sales  tax  less  taxing 14CONFIDENTIAL   &  PROPRIETARY      | https://github.com/paypal/api-­standards/blob/master/api-­style-­guide.md
  • 15. Making  sales  tax  less  taxing 15CONFIDENTIAL   &  PROPRIETARY      | Franchise! -­‐ Value  input -­‐ Pilot  program -­‐ Transparent   feedback
  • 16. Making  sales  tax  less  taxing 16CONFIDENTIAL   &  PROPRIETARY      | Guide  lines  road
  • 17. Making  sales  tax  less  taxing 17CONFIDENTIAL   &  PROPRIETARY      |
  • 18. Making  sales  tax  less  taxing 18CONFIDENTIAL   &  PROPRIETARY      | http://swagger.io/
  • 19. Making  sales  tax  less  taxing 19CONFIDENTIAL   &  PROPRIETARY      | ?
  • 20. Making  sales  tax  less  taxing 20CONFIDENTIAL   &  PROPRIETARY      | Is  it  valid  Swagger?
  • 21. Making  sales  tax  less  taxing 21CONFIDENTIAL   &  PROPRIETARY      | Vendor headers
  • 22. Making  sales  tax  less  taxing 22CONFIDENTIAL   &  PROPRIETARY      | A  single  “source  of  truth”  definition Makes  it  easy  for  technical  writers
  • 23. Making  sales  tax  less  taxing 23CONFIDENTIAL   &  PROPRIETARY      | Swagger  accurately  reflects  API?
  • 24. Making  sales  tax  less  taxing 24CONFIDENTIAL   &  PROPRIETARY      | Follows  company  style  guide?
  • 25. Making  sales  tax  less  taxing 25CONFIDENTIAL   &  PROPRIETARY      |
  • 26. Making  sales  tax  less  taxing 26CONFIDENTIAL   &  PROPRIETARY      | We  still  need  people! • Human-­‐readable   property   definitions • Define  business   flows • Describe  best   practices
  • 27. Making  sales  tax  less  taxing 27CONFIDENTIAL   &  PROPRIETARY      |
  • 28. Making  sales  tax  less  taxing 28CONFIDENTIAL   &  PROPRIETARY      |
  • 29. Making  sales  tax  less  taxing 29CONFIDENTIAL   &  PROPRIETARY      | 2.  https://upload.wikimedia.org/wikipedia/commons/a/af/Bedarra_Island_aerial.jpg 3.  https://upload.wikimedia.org/wikipedia/commons/7/7e/Palau_archipelago.jpg 5.  https://pixabay.com/p-­35105/ 7.  https://www.flickr.com/photos/nelsonminar/286841113 8.  https://upload.wikimedia.org/wikipedia/commons/e/eb/Bicycle_shed.JPG 10.  https://commons.wikimedia.org/wiki/File:United_States_Code_Law_Book_Boston_Public_Library_6D2B1951.jpg 11.  https://www.flickr.com/photos/dominicotine/7696681446 12.  https://c1.staticflickr.com/3/2451/3704243811_55b45a0fd0_b.jpg 15.  https://commons.wikimedia.org/wiki/File:Dog_dressed_in_an_airplane_outfit.jpg http://ichef-­1.bbci.co.uk/news/640/media/images/67206000/jpg/_67206577_de25.jpg 16.  http://s3.freefoto.com/images/21/11/21_11_7_web.jpg 19.  https://c2.staticflickr.com/4/3220/2936038678_06ae77a09d.jpg https://www.flickr.com/photos/dapuglet/8479185386 https://c1.staticflickr.com/3/2792/4195466130_cdccf7f7c3_b.jpg https://c1.staticflickr.com/3/2819/9190710208_cd972cd9c1.jpg https://c1.staticflickr.com/1/2/1616041_2f42627c7b.jpg https://pixabay.com/p-­309065/ 20.  https://www.flickr.com/photos/mbtrama/325408685 https://www.flickr.com/photos/8113246@N02/8203258965 23.  https://www.flickr.com/photos/jurvetson/6877434491 25.  https://upload.wikimedia.org/wikipedia/commons/thumb/0/0b/Sandro_Botticelli_-­_La_nascita_di_Venere_-­ _Google_Art_Project_-­_edited.jpg/1280px-­Sandro_Botticelli_-­_La_nascita_di_Venere_-­_Google_Art_Project_-­_edited.jpg 26.  https://upload.wikimedia.org/wikipedia/commons/thumb/e/e7/Quill_(PSF)_vector.svg/2000px-­ Quill_(PSF)_vector.svg.png 27.  https://www.flickr.com/photos/portland_mike/969236814 Image  Credits
  • 30. Making  sales  tax  less  taxing 30CONFIDENTIAL   &  PROPRIETARY      | Thanks! Anya  Stettler Product  Manager,  API Avalara anyarms anya.stettler@avalara.com