Refactoring specs with new rspec 3 features
Adding missing docs