added/improved normalization and some documentation