updated docs a bit, and sample file, removed sorting code, fixes #1