Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

of

Creating Interactive Docs with Postman Slide 1 Creating Interactive Docs with Postman Slide 2 Creating Interactive Docs with Postman Slide 3 Creating Interactive Docs with Postman Slide 4 Creating Interactive Docs with Postman Slide 5 Creating Interactive Docs with Postman Slide 6 Creating Interactive Docs with Postman Slide 7 Creating Interactive Docs with Postman Slide 8 Creating Interactive Docs with Postman Slide 9 Creating Interactive Docs with Postman Slide 10 Creating Interactive Docs with Postman Slide 11
Upcoming SlideShare
What to Upload to SlideShare
Next
Download to read offline and view in fullscreen.

0 Likes

Share

Download to read offline

Creating Interactive Docs with Postman

Download to read offline

The story of how our small team automated our way to fully customized, interactive API documentation in Postman–including visualizations, example responses, and an OpenAPI-esque object models section. Along the way, we open-sourced much of the workflow and happened to win a hackathon.

Related Books

Free with a 30 day trial from Scribd

See all

Related Audiobooks

Free with a 30 day trial from Scribd

See all
  • Be the first to like this

Creating Interactive Docs with Postman

  1. 1. @carrrson Creating Interactive Docs with Postman How we won the Postman Hackathon and the documentation tools we created along the way Carson Hunter Metadata Technology North America/Postman
  2. 2. Collections Workspace Postman terms to know Requests
  3. 3. Generating from our Swagger/OpenAPI files Creating by hand Previous workflows Creating markdown model tables by hand @carrrson
  4. 4. How can we get this Swagger/OpenAPI functionality in Postman and improve our docs process? Hackathon Brainstorming @carrrson
  5. 5. d ocu-mento r d ocu-mento r Create and inject OpenAPI- esque markdown tables with the Model Creation Collection Keep up with documentation coverage with the Documentation Assistant Collection @carrrson
  6. 6. Part 1: The Model Creation Collection Your users now have a thorough reference for every request and response in your API. We'll discover your request and response models, then create and insert markdown tables describing them, including linking to nested models and the other requests that use them. Original Postman Documentation Collection Run them through the Model Creation collection Adding OpenAPI-esque models to Postman documentation @carrrson
  7. 7. Part 2: Documentation Assistant Grab a collection you've already started documenting Run it through the Documentation Assistant's algorithm (built inside Postman request scripts) Get a report back (in Postman visualizer format) listing out what's still left to do, the percentage complete, and suggested resources to help you along the way Like a code coverage report, but for documentation @carrrson
  8. 8. Documentation Assistant Slack Reports
  9. 9. How you can use these tools Use the MTNA Java models to create your own Postman projects Fork the collection(s) from the Docu-Mentor Postman workspace and run then on your own collections Use the MTNA Newman Example Generator to add examples to your current Postman collections @carrrson 1 2 3
  10. 10. Resources MTNA's Java Postman Models, Newman Example Generator, and Docu-Mentor Java API: https://github.com/mtna/postman-utils Docu-Mentor DevPost submission with video: https://devpost.com/software/docu-mentor @carrrson Docu-Mentor Postman workspace: https://www.postman.com/mtnateam/workspace/docu-mentor

The story of how our small team automated our way to fully customized, interactive API documentation in Postman–including visualizations, example responses, and an OpenAPI-esque object models section. Along the way, we open-sourced much of the workflow and happened to win a hackathon.

Views

Total views

68

On Slideshare

0

From embeds

0

Number of embeds

38

Actions

Downloads

0

Shares

0

Comments

0

Likes

0

×