document some of the issues with the current design