fill in the blanks... and the readme