added documentation on how we fixed this problem