O'Reilly logo

SOA Governance in Action: REST and Web Service Architectures by Jos Dirksen

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

Chapter 4. Service design and documentation policies

This chapter covers

  • Making your services self-documenting
  • Reusing existing standards and definitions
  • Increasing service reusability
  • Versioning your services

If you want to create services that can be easily used by your consumers, you need to provide good documentation and versioning strategies. If you don’t have these in place, you’ll either not get anybody to use your service or, with the first upgrade, scare your existing consumers away with breaking changes. When you keep good documentation, versioning, and reuse in mind during the development phase of your service, you make it a lot easier on your consumers; they have a clear set of documentation on how your service should be used ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required