I think the best way to use REST is to not be cultish about it which just results in more discussions and unread RFCs on your org wiki. I always endup with erring on the side of more documentation