revised filename consistency
a little more documentation

since this is the only immediately reusable part of this repository.