Added Pierre's suggestions to the docs. Working on a general effect example.