add documentation for #162
remove some garbage