Improve documentation and fix RDoc a little bit.

Signed-off-by: Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>
Fix "summary" and "description" files in Gem specification.

Signed-off-by: Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>