document some issues