Free Trial

Safari Books Online is a digital library providing on-demand subscription access to thousands of learning resources.


  • Create BookmarkCreate Bookmark
  • Create Note or TagCreate Note or Tag
  • DownloadDownload
  • PrintPrint
Share this Page URL
Help

5. Documenting Hypermedia > Design and Implementation Tips

Design and Implementation Tips

Aside from the details of proper documentation, registration, and maintenance of a media type design, it helps to keep some general design and implementation tips in mind when creating a new media type or applying a domain-specific implementation to an existing hypermedia type. Below are some additional insights and advice from a number of sources that can assist in building quality, robust, and useful hypermedia APIs.

Joshua Bloch’s Characteristics of a Good API

In 2006, Joshua Bloch gave a talk entitled “How to Design a Good API and Why it Matters.” While his talk was not geared toward media type designers, his list of “Characteristics of a Good API” is still applicable to hypermedia designs.


  

You are currently reading a PREVIEW of this book.

                                                                                        

Get instant access to over
$1 million worth of books and videos.

  

Start a Free Trial