fix bug in colour_clusters when labels are not unique

* closes #1
* thanks to Kamila Naxerova for the bug report
some additional package docs 
* by way of orientation