diff --git a/lib/jsonapi/serializable/resource/dsl.rb b/lib/jsonapi/serializable/resource/dsl.rb
index 8ec0261..eef98cc 100644
--- a/lib/jsonapi/serializable/resource/dsl.rb
+++ b/lib/jsonapi/serializable/resource/dsl.rb
@@ -150,6 +150,16 @@ def meta(value = nil, &block)
         #       { author_online: @object.author.online? }
         #     end
         #   end
+        #
+        # @example
+        #   relationship :books do
+        #     data do
+        #       @object.books
+        #     end
+        #     linkage do
+        #       @object.books.map { |book| { id: book.id.to_s, type: 'books', name: book.name } }
+        #     end
+        #   end
         def relationship(name, options = {}, &block)
           rel_block = proc do
             data { @object.public_send(name) }