add note about restful design