improve documentation for dirty hack