fixing bad filenames + adding doc