Add a REST principles chapter to the guide

This is a complex subject so hopefully I did not introduce
errors while trying to explain it.