Improve docs, gemspec and code readability