Improved clause 8

Further improvements in documentation