Fix many typos in docs

Docs had numerous small typos - due to repeating template these got reproduced many times. Now we are going to cf-docs this was very visible.
Updated Gemfile for deprecation of :rubygems magic symbol
TODO: split API doc generated markdown into separate pages per entity.