add README; update filenames to documentation