Code review comment for lp:~mbp/bzr/doc-cleanup

Arg... another example of:
https://bugs.edge.launchpad.net/launchpad-code/+bug/338002

Anyway, I approve of not generating the performance.png except on demand. I'll assume that all the other changes are just bug #338002