README.markdown in roar-0.12.3 vs README.markdown in roar-0.12.4

- old
+ new

@@ -178,10 +178,11 @@
 puts album.songs[1] #=> #<Song title="Roadblock">
 ```
 
 The nesting of two representers can map composed object as you find them in many many APIs.
 
+In case you're after virtual nesting, where a nested block in your document still maps to the same outer object, [check out the `::nested` method](https://github.com/apotonick/representable#document-nesting).
 
 ## Inline Representer
 
 Sometimes you don't wanna create two separate representers - although it makes them reusable across your app. Use inline representers if you're not intending this.
 
@@ -352,9 +353,11 @@
   link :self do
     "http://songs/#{title}"
   end
 end
 ```
+
+Documentation for HAL can be found in the [API docs](http://rdoc.info/github/apotonick/roar/Roar/Representer/JSON/HAL).
 
 ### Hypermedia
 
 Including the `Roar::Representer::JSON::HAL` module adds some more DSL methods to your module. It still allows using `::link` but treats them slightly different.
 
\ No newline at end of file