improve RB docs

FC (Fay) Stegermanrequested to merge
obfusk/fdroid-website:improve-rb-docs-2 into master

I included (my suggested improvement of) @linsui's !886 (closed) as well.

cc @licaon-kter @eighthave

Merge request reports