I've revised the decorator section. Perhaps it may be clearer now. Feedback welcome.