document better a hack we use