Updated documentation
Updated documentation

- Fixed example demonstrating adding "describedby" link to resources/collections
- Minor fixes throughout

Cube-Solutions/zf-hal,Wilt/zf-hal,nobesnickr/zf-hal,weierophinney/zf-api-problem,weierophinney/zf-api-problem,weierophinney/zf-api-problem,vixriihi/zf-jsonld,rstgroup/zf-api-problem,Cube-Solutions/zf-hal,rstgroup/zf-api-problem,rstgroup/zf-api-problem,nocvp/zf-api-problem,Cube-Solutions/zf-hal,nocvp/zf-rest,Wilt/zf-rest