One of the examples was still referring to the old way of defining
directors, which I am sure is confusing for the new users this
document is meant for.

Noticed by: coredump on irc.

Used the occation to do some minor scrubbing of the text.