documentation: clustering guide fixes
Merge pull request #1247 from jonboulle/doc

documentation: clustering guide fixes