include better documentation for hacks