Still, it's good to have an example, but if a complicated feature needs some explanation I think it would be more useful to have a page in the narrative docs explaining what's going on (possibly with still images to illustrate).