improve the dirty dirty docs