a collection of workarounds and notes