more easily customizable

added much more detailed comments