Misc cleanups

@fosdev Please review and merge!
Following PR has fixes:
1) Meaningful warning message if target doesn't have 'source' method on it.
2) Required top-level 'profile' link in API doc is replaced with 'self'
4) 'undefined method `decorate' for nil:NilClass (NoMethodError)' , when there is no 'name:self' on a transition. Fix for self_transition method.
5) Put back response_headers in API document. 
Should have a spec that was catching this somewhere I think.