fixes specs
Improves documentation