fix data structure comment
document colour scheme