Add better docs; closes #1,#2
Merge docs from legacy clustering branch.