also: some file-level documentation explaining what happens within would be awesome.