DZone
Integration Zone
Thanks for visiting DZone today,
Edit Profile
  • Manage Email Subscriptions
  • How to Post to DZone
  • Article Submission Guidelines
Sign Out View Profile
  • Post an Article
  • Manage My Drafts
Over 2 million developers have joined DZone.
Log In / Join
  • Refcardz
  • Trend Reports
  • Webinars
  • Zones
  • |
    • Agile
    • AI
    • Big Data
    • Cloud
    • Database
    • DevOps
    • Integration
    • IoT
    • Java
    • Microservices
    • Open Source
    • Performance
    • Security
    • Web Dev
DZone > Integration Zone > Writing Comprehensive, Guaranteed, Up-to-Date REST API Documentation [Video]

Writing Comprehensive, Guaranteed, Up-to-Date REST API Documentation [Video]

RESTful API documentation is often a topic of frustration for API developers and users. It doesn't have to be this way! Spring REST docs can help.

Pieter Humphrey user avatar by
Pieter Humphrey
CORE ·
Feb. 16, 17 · Integration Zone · Presentation
Like (3)
Save
Tweet
6.50K Views

Join the DZone community and get the full member experience.

Join For Free

RESTful APIs are eating the world — yet all too often, the documentation can cause indigestion for the API developers and users. Developers have to deal with annotation overload, repetition, and an unpleasant writing environment. Users are then left with documentation that’s inaccurate and difficult to use. It doesn’t have to be this way.

This talk will introduce Spring REST docs and their test-driven approach to RESTful API documentation. We’ll look at how they combine the power of Asciidoctor and your integration tests to produce documentation that’s accurate and easy-to-read while keeping your code DRY and free from annotation overload. We’ll also look at some of the features that are new in Spring REST Docs 1.1, including support for REST Assured and Markdown.

You can check out the slides here, or view the video below.

REST Web Protocols API Documentation

Published at DZone with permission of Pieter Humphrey, DZone MVB. See the original article here.

Opinions expressed by DZone contributors are their own.

Popular on DZone

  • Anatomy of a Webhook HTTP Request
  • Remote Debugging and Developer Observability
  • What's the Difference Between Static Class vs. Singleton Patterns in C#?
  • Event-Driven Hello World Program

Comments

Integration Partner Resources

X

ABOUT US

  • About DZone
  • Send feedback
  • Careers
  • Sitemap

ADVERTISE

  • Advertise with DZone

CONTRIBUTE ON DZONE

  • Article Submission Guidelines
  • MVB Program
  • Become a Contributor
  • Visit the Writers' Zone

LEGAL

  • Terms of Service
  • Privacy Policy

CONTACT US

  • 600 Park Offices Drive
  • Suite 300
  • Durham, NC 27709
  • support@dzone.com
  • +1 (919) 678-0300

Let's be friends:

DZone.com is powered by 

AnswerHub logo