I've added my comments. As usual, please fix/amend where needed.
Thanks, Ignasi! Some text edits at https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=71013050&selectedPageVersions=5&selectedPageVersions=4.
@Ignasi: please check that I haven't accidentally changed the meaning of any of your comments.
Regards ap
