I do like the idea of having examples in-section. It took me a couple of readthroughs to get everything so examples might help that